Wildwood Platform Documentation

Everything you need to integrate WildwoodComponents into your applications. Available for .NET Blazor, React, React Native, and Node.js. Configure the platform through WildwoodAdmin and work with the WildwoodAPI.

Multi-Platform SDKs Documentation covers .NET (Blazor Server, WebAssembly, MAUI), React, React Native, and Node.js. Source code is available on GitHub.

Quick Start

Get up and running with WildwoodComponents in minutes:

dotnet add package WildwoodComponents

// Program.cs
builder.Services.AddWildwoodComponents(options =>
{
    options.BaseUrl = "https://your-api.wildwood.example.com";
});

<AuthenticationComponent
    AppId="@AppId"
    OnAuthenticationSuccess="@HandleLogin" />

pnpm add @wildwood/core @wildwood/react

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

function App() {
  return (
    <WildwoodProvider config={{
      baseUrl: 'https://your-api.wildwood.example.com',
      appId: 'your-app-id',
    }}>
      <AuthenticationComponent
        onAuthenticationSuccess={(resp) => console.log('Logged in!', resp)}
      />
    </WildwoodProvider>
  );
}

pnpm add @wildwood/core @wildwood/node

import express from 'express';
import { createAuthMiddleware } from '@wildwood/node';

const app = express();
const auth = createAuthMiddleware({
  baseUrl: 'https://your-api.wildwood.example.com',
  apiKey: process.env.WILDWOOD_API_KEY!,
});

app.use('/api', auth);

Read the full Getting Started guide →

Documentation Sections

Getting Started

Installation, service registration, and your first component integration.

Authentication & Session

Session management, token refresh, 2FA, and the complete login flow architecture.

Component Reference

Detailed reference for all components: Authentication, AI Chat, Messaging, Payment, and more.

WildwoodAdmin Guide

How to use the admin interface: manage apps, users, companies, payments, and configurations.

API Reference

WildwoodAPI endpoints for authentication, AI services, user management, and security.

Platform Architecture

The Wildwood Platform consists of the following components:

Component	Description	Technology
WildwoodAPI	Backend REST API with JWT authentication, multi-tenant data isolation, and Entity Framework	.NET 9, SQL Server
WildwoodAdmin	Admin interface for managing apps, users, companies, AI configurations, and payments	Razor Pages + Blazor Server
WildwoodComponents (.NET)	Reusable Blazor component library for authentication, AI chat, messaging, payments, subscriptions, and notifications	Blazor (Server/WASM/MAUI)
`@wildwood/core`	Framework-agnostic TypeScript SDK — API client, auth, session management, and all service modules	TypeScript (browser + Node.js)
`@wildwood/react`	React hooks and pre-built components wrapping the core SDK	React 18+
`@wildwood/react-native`	React Native components using native primitives (View, Text, Pressable)	React Native / Expo
`@wildwood/node`	Express middleware for JWT validation, API proxying, and server-side admin operations	Node.js 18+ / Express

Open Source: The JavaScript/TypeScript SDK packages are available on GitHub.

Key Features

Multi-tenant architecture — All data isolated by AppId for secure multi-tenancy
Cross-platform — Components for Blazor (Server/WASM/MAUI), React, React Native, and Node.js
Automatic session management — Proactive token refresh, expiry detection, and session recovery
Comprehensive authentication — Local login, OAuth providers, passkeys/WebAuthn, 2FA, trusted devices
AI integration — Chat with TTS/STT, session management, multiple AI provider support
Payment processing — Stripe, PayPal, Apple Pay, Google Pay with embedded scripts (no CDN)
Theming system — Built-in themes with CSS custom properties for easy customization