{ "$schema": "https://ui.shadcn.com/schema/registry-item.json", "name": "auth-better-auth", "type": "registry:block", "title": "Better Auth", "description": "Better Auth server config, Next.js route handler, and typed client starter.", "dependencies": [ "better-auth" ], "devDependencies": [], "registryDependencies": [], "files": [ { "path": "apps/web/src/lib/auth.ts", "type": "registry:file", "target": "apps/web/src/lib/auth.ts", "content": "import { betterAuth } from \"better-auth\";\n\nexport const auth = betterAuth({\n emailAndPassword: { enabled: true },\n socialProviders: {},\n});\n" }, { "path": "apps/web/src/lib/auth-client.ts", "type": "registry:file", "target": "apps/web/src/lib/auth-client.ts", "content": "import { createAuthClient } from \"better-auth/react\";\n\nexport const authClient = createAuthClient({\n baseURL: process.env.NEXT_PUBLIC_APP_URL,\n});\n" }, { "path": "apps/web/src/app/api/auth/[...all]/route.ts", "type": "registry:file", "target": "apps/web/src/app/api/auth/[...all]/route.ts", "content": "import { toNextJsHandler } from \"better-auth/next-js\";\n\nimport { auth } from \"@/lib/auth\";\n\nexport const { GET, POST } = toNextJsHandler(auth);\n" }, { "path": "apps/web/src/app/(console)/admin/auth/better-auth/page.tsx", "type": "registry:page", "target": "apps/web/src/app/(console)/admin/auth/better-auth/page.tsx", "content": "const checks = [\n \"Install provider package and configure env\",\n \"Run the local example path\",\n \"Add auth, retries, and audit events before production\",\n];\n\nexport default function BetterAuthPage() {\n return (\n
\n
\n

Better Auth

\n

Self-hosted TypeScript auth with email/password, plugins, and App Router handlers.

\n
\n
\n {checks.map((check) => (\n
{check}
\n ))}\n
\n
\n );\n}\n" } ], "maintenanceSkills": [ { "name": "auth-better-auth", "target": ".stackfoundry/skills/auth-better-auth/SKILL.md", "content": "---\nname: auth-better-auth\ndescription: Maintain the Better Auth provider adapter module installed by StackFoundry.\n---\n\n# Better Auth Skill\n\n## Boundary\n\nThis block owns the Better Auth integration example only. Keep product-specific business logic outside the provider adapter until the app has chosen this provider.\n\n## Shared Skills\n\nWhen provider, framework, or database behavior changes, load the installed shared skill before editing implementation details:\n\n- `.stackfoundry/skills/better-auth/SKILL.md` (source: `registry/skills/better-auth/SKILL.md`)\n- `.stackfoundry/skills/nextjs/SKILL.md` (source: `registry/skills/nextjs/SKILL.md`)\n\nKeep this module skill focused on ownership, installed files, env vars, deployment checks, and module-specific invariants.\n\n## Source Files\n\n- `apps/web/src/lib/auth.ts`\n- `apps/web/src/lib/auth-client.ts`\n- `apps/web/src/app/api/auth/[...all]/route.ts`\n- `apps/web/src/app/(console)/admin/auth/better-auth/page.tsx`\n\n## Dependencies\n\n- `better-auth`\n\n## Environment\n\n- `BETTER_AUTH_SECRET`\n- `BETTER_AUTH_URL`\n\n## Deployment Checks\n\n- Create the provider project/resource before deploying.\n- Add env vars to preview and production environments.\n- Run the included smoke route, task, worker, or helper after deploy.\n- Confirm logs do not include secrets, tokens, raw webhook payloads, or customer data.\n\n## Maintenance Rules\n\n- Keep SDK imports and examples aligned with current provider docs.\n- Keep secrets server-only and out of client components.\n- Update `module.json`, `docs.md`, and `tests/checklist.md` together when dependencies, env vars, or files change.\n- Prefer small provider adapters over coupling shared domain modules to one provider.\n" }, { "name": "better-auth", "target": ".stackfoundry/skills/better-auth/SKILL.md", "content": "---\nname: better-auth\ndescription: Better Auth guidance for installed auth modules.\n---\n\n# Better Auth Guidance\n\n## Installed Location\n\n- Installed target: `.stackfoundry/skills/better-auth/SKILL.md`\n- Registry source: `registry/skills/better-auth/SKILL.md`\n\nAgents maintaining an installed module should load this shared skill from the installed target when provider, framework, database, SDK, or platform behavior is involved. Keep provider-specific API details here instead of duplicating them inside module maintenance skills.\n\n- Keep auth server config isolated from UI code.\n- Document session, organization, and adapter assumptions.\n- Do not mix provider behavior into shared auth modules.\n- Verify protected routes and account lifecycle flows.\n" }, { "name": "nextjs", "target": ".stackfoundry/skills/nextjs/SKILL.md", "content": "---\nname: nextjs\ndescription: Maintain Next.js App Router code installed by StackFoundry modules.\n---\n\n# Next.js Operating Instructions\n\n## Installed Location\n\n- Installed target: `.stackfoundry/skills/nextjs/SKILL.md`\n- Registry source: `registry/skills/nextjs/SKILL.md`\n\nAgents maintaining an installed module should load this shared skill from the installed target when provider, framework, database, SDK, or platform behavior is involved. Keep provider-specific API details here instead of duplicating them inside module maintenance skills.\n\n- Keep server-only data access out of Client Components.\n- Put route handlers under `app/api` and UI routes under the relevant App Router segment.\n- Prefer Server Components for data loading and add `\"use client\"` only for interactivity.\n- Keep public environment variables prefixed with `NEXT_PUBLIC_`; keep secrets server-only.\n- Re-run typecheck and build after changing route handlers, layouts, or shared app configuration.\n" } ], "envVars": { "BETTER_AUTH_SECRET": "", "BETTER_AUTH_URL": "" }, "docs": "# Better Auth Module\n\nBetter Auth server config, Next.js route handler, and typed client starter.\n\n## Official Docs\n\n- [Better Auth Docs](https://www.better-auth.com/docs)\n\n## Owns\n\n- `apps/web/src/lib/auth.ts`\n- `apps/web/src/lib/auth-client.ts`\n- `apps/web/src/app/api/auth/[...all]/route.ts`\n- `apps/web/src/app/(console)/admin/auth/better-auth/page.tsx`\n\n## Dependencies\n\n`better-auth`\n\n## Environment\n\n- `BETTER_AUTH_SECRET`\n- `BETTER_AUTH_URL`\n\n## Maintenance\n\n- Keep this module focused on the provider adapter boundary.\n- Keep secrets in environment variables and never commit local credentials.\n- Verify the example route or worker path before promoting this module beyond experimental.\n- Update docs, checklist, and manifest metadata when provider APIs change.\n", "meta": { "category": "auth", "env": [ "BETTER_AUTH_SECRET", "BETTER_AUTH_URL" ], "status": "ready", "maturity": "ready", "recommendedFor": [] } }