Service Registration

Register all WildwoodComponents services in your application's DI container with a single call to AddWildwoodComponents().

Overview

WildwoodComponents uses a single initialization call to wire up all services. The approach varies by platform:

// Program.cs
builder.Services.AddWildwoodComponents(options =>
{
    options.BaseUrl = "https://api.myapp.com";
    options.AppId = "your-app-id";
    options.EnableAutoTokenRefresh = true;
    options.SessionExpirationMinutes = 60;
});

import { WildwoodProvider } from '@wildwood/react';

function App() {
  return (
    <WildwoodProvider config={{
      baseUrl: 'https://api.myapp.com',
      appId: 'your-app-id',
      enableAutoTokenRefresh: true,
      sessionExpirationMinutes: 60,
    }}>
      <Router />
    </WildwoodProvider>
  );
}

import { WildwoodProvider } from '@wildwood/react-native';

function App() {
  return (
    <WildwoodProvider config={{
      baseUrl: 'https://api.myapp.com',
      appId: 'your-app-id',
      enableAutoTokenRefresh: true,
      storage: 'memory',
    }}>
      <NavigationContainer>
        {/* Your screens */}
      </NavigationContainer>
    </WildwoodProvider>
  );
}

import { createAuthMiddleware, createAdminClient } from '@wildwood/node';

// JWT validation middleware
const auth = createAuthMiddleware({
  baseUrl: 'https://api.myapp.com',
  apiKey: process.env.WILDWOOD_API_KEY,
});

// Server-side admin client
const admin = createAdminClient({
  baseUrl: 'https://api.myapp.com',
  apiKey: process.env.WILDWOOD_API_KEY,
});

Blazor Configuration Options

The .NET SDK has three overloads for AddWildwoodComponents():

Option 1: Simple URL Registration

The simplest way to get started. Pass just the base URL of your WildwoodAPI instance:

// Program.cs
builder.Services.AddWildwoodComponents("https://localhost:7046");

This uses default values for all other settings. It is equivalent to:

builder.Services.AddWildwoodComponents(options =>
{
    options.BaseUrl = "https://localhost:7046";
});

Option 2: Lambda Configuration

For full control over options, use the lambda overload:

// Program.cs
builder.Services.AddWildwoodComponents(options =>
{
    options.BaseUrl = "https://api.myapp.com";
    options.ApiKey = "your-api-key";
    options.AppId = "d6e61c7a-eec5-4164-a004-9b99eb5eb6de";

    // Session management
    options.SessionExpirationMinutes = 60;
    options.EnableAutoTokenRefresh = true;
    options.SlidingExpiration = true;
    options.PersistentSession = false;

    // HTTP settings
    options.RequestTimeoutSeconds = 30;
    options.EnableRetry = true;
    options.MaxRetryAttempts = 3;

    // Security
    options.EnableAntiforgeryValidation = true;

    // Debugging
    options.EnableDetailedErrors = false;
});

Option 3: Configuration from appsettings.json

Read all options from your application configuration. This is the recommended approach for production deployments because settings can vary per environment without code changes:

// Program.cs
builder.Services.AddWildwoodComponents(builder.Configuration, "WildwoodAPI");

The second parameter is the configuration section name. It defaults to "WildwoodAPI" if omitted:

// These two calls are equivalent:
builder.Services.AddWildwoodComponents(builder.Configuration, "WildwoodAPI");
builder.Services.AddWildwoodComponents(builder.Configuration);

Example appsettings.json

{
  "WildwoodAPI": {
    "BaseUrl": "https://api.myapp.com",
    "ApiKey": "your-api-key",
    "AppId": "d6e61c7a-eec5-4164-a004-9b99eb5eb6de",
    "SessionExpirationMinutes": 60,
    "EnableAutoTokenRefresh": true,
    "SlidingExpiration": true,
    "PersistentSession": false,
    "RequestTimeoutSeconds": 30,
    "EnableDetailedErrors": false,
    "EnableAntiforgeryValidation": true
  }
}

Configuration Options Reference

The WildwoodComponentsOptions class exposes the following settings:

What Gets Registered

A single call to AddWildwoodComponents() registers all of the following services. You do not need to register them individually.

Blazor Server Additional Setup

If you are using Blazor Server (not WebAssembly), you also need to add server-side Blazor services. This is typically already in your Program.cs but verify it is present:

// Program.cs - Blazor Server
builder.Services.AddServerSideBlazor();
builder.Services.AddWildwoodComponents("https://localhost:7046");

MAUI Additional Setup

For .NET MAUI Blazor Hybrid apps, register services in your MauiProgram.cs:

// MauiProgram.cs
builder.Services.AddMauiBlazorWebView();
builder.Services.AddWildwoodComponents(options =>
{
    options.BaseUrl = "https://api.myapp.com";
    options.AppId = "your-app-id";
    options.EnableAutoTokenRefresh = true;
    options.PersistentSession = true;  // Keep sessions across app restarts
});

Complete Program.cs Example

Here is a full Program.cs for a Blazor Server application with WildwoodComponents:

var builder = WebApplication.CreateBuilder(args);

// Add Razor Pages and Blazor
builder.Services.AddRazorPages();
builder.Services.AddServerSideBlazor();

// Register WildwoodComponents from configuration
builder.Services.AddWildwoodComponents(builder.Configuration, "WildwoodAPI");

var app = builder.Build();

// Configure the HTTP request pipeline
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();

app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

app.Run();

With services registered, you are ready to use your first WildwoodComponent. Continue to Your First Component to see it in action.