App shell starter module
Setup
The canonical stack declaration, a setup script that prepares local settings, and the choose-your-stack guide.
- Files
- 27
- Lines
- 1,597
- Languages
- Config + Markdown + TypeScript + CSS + JSON
Included files
This page lists paths and purposes, not source contents.
.env.example
Configuration required by this starter pack.
Config
12 lines
ADAPT.md
Give these instructions to the coding agent working in the buyer's project.
Markdown
155 lines
AGENTS.md
This version has breaking changes — APIs, conventions, and file structure may all differ from your training data.
Markdown
9 lines
app/api/session/signin/route.ts
Mounts the demo sign-in handler at its public app address.
TypeScript
8 lines
app/api/session/signout/route.ts
Mounts the demo sign-out handler at its public app address.
TypeScript
8 lines
app/api/verify/route.ts
Mounts the live setup report at its public app address.
TypeScript
9 lines
app/dashboard/page.tsx
Shows the signed-in account and the paid-access seam.
TypeScript
81 lines
app/globals.css
Configuration required by this starter pack.
CSS
365 lines
app/layout.tsx
Provides the shared page frame, navigation, and search details.
TypeScript
39 lines
app/not-found.tsx
Gives missing pages a useful way back to the app.
TypeScript
14 lines
app/page.tsx
Introduces the runnable app shell, its live stack state, and every pack that plugs in.
TypeScript
108 lines
app/robots.ts
Tells search engines which public pages they may visit.
TypeScript
17 lines
app/signin/page.tsx
Shows the demo sign-in form or points to the active auth provider.
TypeScript
47 lines
app/sitemap.ts
Lists the public pages that search engines should discover.
TypeScript
15 lines
app/tilt-card.tsx
Gives a card pointer-tracked tilt and glare, with zero dependencies.
TypeScript
63 lines
CLAUDE.md
Configuration required by this starter pack.
Markdown
1 lines
next-env.d.ts
/ <reference types="next" />
TypeScript
7 lines
OPERATIONS.md
1.
Markdown
48 lines
package.json
Configuration required by this starter pack.
JSON
25 lines
README.md
This starter is a complete runnable application frame that works the moment it is installed.
Markdown
61 lines
src/setup/check-setup.ts
Prepares local settings and reports which app providers are ready.
TypeScript
141 lines
src/setup/stack-config.ts
The canonical stack declaration: one trusted record of which provider owns
TypeScript
60 lines
src/setup/stack-options.ts
The catalog of everything that can plug into this shell, with live state:
TypeScript
133 lines
src/setup/STACK.md
Each concern has license-included choices.
Markdown
69 lines
starter.json
Configuration required by this starter pack.
JSON
6 lines
TROUBLESHOOTING.md
**Sign in returns to the sign-in page**
Markdown
55 lines
tsconfig.json
Configuration required by this starter pack.
JSON
41 lines
Questions about setup
Is this a Next.js boilerplate?
It plays the same opening role with a different design. A boilerplate freezes one vendor stack on day one. The shell runs immediately on built-in defaults (a demo sign-in, an in-memory store, log-only email and analytics) and leaves every vendor decision open behind a named seam, so you choose auth, payments, and email when you are ready, from packs that were each tested on their own.
Which providers can plug in?
Sign-in: Supabase, Clerk, or Firebase. Database: Supabase, Firebase, or Cloudflare. Payments: Stripe or Whop. Email: Resend or Mailgun. Analytics: GA4 or PostHog. Errors: Sentry. Hosting: Vercel or Cloudflare. AI features: OpenAI, Claude, or Gemini. Every listed pack is included with the license.