Installation

Install the React SDK packages via npm or pnpm:

npm install @wildwood/core @wildwood/react

Or with pnpm:

pnpm add @wildwood/core @wildwood/react

The @wildwood/core package provides the API client and services. The @wildwood/react package provides React hooks and pre-built components.

Install the React Native SDK packages:

npm install @wildwood/core @wildwood/react-native

The @wildwood/react-native package provides native components using View, Text, and Pressable instead of HTML.

Install the Node.js SDK for server-side usage:

npm install @wildwood/core @wildwood/node

The @wildwood/node package provides Express middleware for JWT validation and API proxying. Express is an optional peer dependency.

App Entry Point

Wrap your app with WildwoodProvider to initialize the SDK:

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

function App() {
  return (
    <WildwoodProvider config={{
      baseUrl: 'https://api.example.com',
      appId: 'your-app-id',
      enableAutoTokenRefresh: true,
    }}>
      {/* Your routes and components */}
    </WildwoodProvider>
  );
}

Import components and hooks as needed:

import { useAuth, AuthenticationComponent } from '@wildwood/react';
import type { AuthenticationResponse } from '@wildwood/core';

App Entry Point

Wrap your app with WildwoodProvider:

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

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

Import hooks and components:

import { useAuth, useTheme } from '@wildwood/react-native';

Express Middleware Setup

Add the auth middleware to your Express app:

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

const app = express();

// Validate JWT tokens on protected routes
const auth = createAuthMiddleware({
  baseUrl: 'https://api.example.com',
  apiKey: process.env.WILDWOOD_API_KEY,
});

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

// Access validated user in route handlers
app.get('/api/profile', (req, res) => {
  res.json(req.wildwoodUser);
});

Run a TypeScript type check to verify everything is wired up correctly:

npx tsc --noEmit

You should see no type errors. If you see missing module errors, double-check that:

1. Both @wildwood/core and your framework package are installed.
2. Your tsconfig.json has "moduleResolution": "bundler" or "node16".
3. You have run npm install or pnpm install.