@mdxui/auth 1.4.1 → 1.4.2

package/README.md

@@ -85,6 +85,137 @@ function App() {
 }
 ```
 
+### Prebuilt Static App (Cloudflare Workers / Static Hosting)
+
+For deployments where you don't want a build step, use the prebuilt app. The package includes a complete SPA in the `app/` directory with all CSS (Tailwind), React, and routing bundled.
+
+#### Option A: Serve with Hono (Recommended)
+
+Use Hono to serve the prebuilt app with config injection from environment variables:
+
+**wrangler.toml:**
+```toml
+name = "my-auth-app"
+main = "src/index.ts"
+
+[assets]
+directory = "node_modules/@mdxui/auth/app"
+
+[vars]
+WORKOS_CLIENT_ID = "client_01EXAMPLE"
+APP_NAME = "My App"
+```
+
+**src/index.ts:**
+```ts
+import { Hono } from 'hono'
+
+type Bindings = {
+  ASSETS: Fetcher
+  WORKOS_CLIENT_ID: string
+  APP_NAME?: string
+  APP_TAGLINE?: string
+  LOGO_URL?: string
+}
+
+const app = new Hono<{ Bindings: Bindings }>()
+
+// Serve config from environment variables
+app.get('/auth-config.json', (c) => {
+  return c.json({
+    clientId: c.env.WORKOS_CLIENT_ID,
+    appName: c.env.APP_NAME ?? 'App',
+    tagline: c.env.APP_TAGLINE,
+    logoUrl: c.env.LOGO_URL,
+  })
+})
+
+// Serve static assets (SPA fallback handled by assets)
+app.all('*', async (c) => {
+  return c.env.ASSETS.fetch(c.req.raw)
+})
+
+export default app
+```
+
+#### Option B: Vanilla Worker
+
+If you're not using Hono, use the standard Worker API:
+
+**src/index.ts:**
+```ts
+export interface Env {
+  ASSETS: Fetcher
+  WORKOS_CLIENT_ID: string
+  APP_NAME?: string
+}
+
+export default {
+  async fetch(request: Request, env: Env): Promise<Response> {
+    const url = new URL(request.url)
+
+    // Serve config from environment variables
+    if (url.pathname === '/auth-config.json') {
+      return Response.json({
+        clientId: env.WORKOS_CLIENT_ID,
+        appName: env.APP_NAME ?? 'App',
+      })
+    }
+
+    // Serve static assets
+    return env.ASSETS.fetch(request)
+  }
+}
+```
+
+Both approaches:
+- No copying files needed
+- Config comes from secure environment variables
+- Easy to update by bumping the package version
+
+#### Option C: Copy to Static Directory
+
+Copy the prebuilt app and add your config file:
+
+**1. Install and copy:**
+```bash
+pnpm add @mdxui/auth
+cp -r node_modules/@mdxui/auth/app/* public/
+```
+
+**2. Create `public/auth-config.json`:**
+```json
+{
+  "clientId": "client_01EXAMPLE",
+  "appName": "My App"
+}
+```
+
+**3. Configure wrangler.toml:**
+```toml
+name = "my-auth-app"
+
+[assets]
+directory = "public"
+```
+
+This approach:
+- Works with any static hosting (Netlify, Vercel, S3, etc.)
+- Config is a static file in your repo
+- Requires re-copying after package updates
+
+#### Config Options
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `clientId` | Yes | WorkOS client ID |
+| `appName` | No | App name (default: "App") |
+| `tagline` | No | Subtitle shown in sidebar |
+| `redirectUri` | No | OAuth redirect URI |
+| `apiHostname` | No | WorkOS API hostname |
+| `devMode` | No | Enable dev mode (default: false) |
+| `logoUrl` | No | URL to logo image |
+
 ### Traditional Setup (Without Shell)
 
 ```tsx