Make It Yours
Customization Guide
Use this guide to keep Foundation code, adapt Example modules, enable Optional integrations, and label Coming Soon work honestly.
FoundationExampleOptionalComing Soon
Live Setup Contract
Your current setup
These values were written by the setup script and reflect how this project was configured. They are read-only here — re-run npm run setup to change them safely (it updates src/core/setup/generated.ts for you).
Setup Mode
Core (default)
Start with the default baseline. You can opt into Advanced later without reinstalling.
Preset
Product Workspace
A clear public story with a credible working space behind it.
Optional Module
Launch checklist
IncludedA small starter checklist that makes the first-run path obvious and can be removed later if it stops being useful.
Site Metadata
- Site Name
- next-foundry
- Site Description
- A clear public story with a credible working space behind it.
- OG Image URL
- Not set
Keep This
What to keep as-is
These foundational pieces took significant effort to set up correctly. Keep them and build on top.
Authentication setup
The Clerk integration, middleware config, and route group layout in (auth)/ use solid, real-world defaults. Keep them and just configure your Clerk project.
Prisma ORM wiring
The Prisma client singleton pattern (src/lib/db.ts), schema structure, and migration workflow are solid foundations. Extend the schema for your models.
UI component system
shadcn/ui + Tailwind v4 + dark mode is a great base. Keep the globals.css @theme inline config and just add/remove individual components as needed.
Developer tooling
ESLint, Prettier, Husky, Vitest, Playwright, and the GitHub Actions CI pipeline represent weeks of setup. Keep all of it.
Layout patterns
The Header, Footer, Sidebar, and MobileNav structure is solid. Keep the architecture and replace the branding (name, logo, nav links).
Replace This
What to replace / customize
These are placeholders intentionally left generic. Replace them with your actual content.
Branding
src/components/layout/Header.tsx — Change "next-foundry" to your app namesrc/components/layout/Footer.tsx — Update copyright, links, social handlessrc/components/layout/Sidebar.tsx — Replace brand name and logo iconsrc/app/layout.tsx — Update metadata title and descriptionpublic/favicon.ico — Replace with your favicon
Data models
prisma/schema.prisma — Add your domain models (Post, Product, Order, etc.)prisma/seed.ts — Seed with realistic test data for your domainsrc/app/api/ — Add your own API routes and server actions
Dashboard content
src/app/(dashboard)/dashboard/page.tsx — Replace mock stats with real datasrc/app/(dashboard)/dashboard/analytics/page.tsx — Hook up a real chart librarysrc/app/(dashboard)/dashboard/team/page.tsx — Pull team members from your databasesrc/app/(dashboard)/dashboard/profile/page.tsx — Load real user data from Clerk/DB
Color scheme
src/app/globals.css — Update the HSL CSS custom properties in :root and .darktailwind.config.mjs — Add custom Tailwind tokens if neededcomponents.json — Update the shadcn/ui base color if regenerating components
Remove This
What to remove
These items exist for demonstration. Clean them up before launching your product.
Demo/mock data
high priorityAll data in dashboard pages (stats, activity feed, team members, etc.) is hardcoded mock data. Replace with real database queries before launching.
const stats, recentActivity, teamMembers in dashboard/page.tsxconst projects in dashboard/projects/page.tsxconst apiKeys in dashboard/api-keys/page.tsx
Unused dashboard routes
medium priorityIf your app doesn't need all eight dashboard modules, delete the ones you don't need. Unused routes add to bundle size and maintenance surface.
src/app/(dashboard)/dashboard/analytics/ — Remove if not neededsrc/app/(dashboard)/dashboard/changelog/ — Remove if not neededsrc/app/(dashboard)/dashboard/notifications/ — Remove if not needed
GSAP animations (optional)
low priorityGSAP is included for polish. If you don't need animations, remove it to save ~100KB. Replace FadeIn and StaggerChildren with plain divs.
npm uninstall gsap @gsap/reactDelete src/components/animations/ directoryReplace <FadeIn> with <div> and <StaggerChildren> with <div>
Admin panel (if not needed)
low priorityThe admin panel at /admin is a starting point with mock data. Remove it entirely if your app doesn't require an admin interface.
Delete src/app/(admin)/ directoryRemove admin links from Header.tsx and CommandPalette.tsx
Public marketing routes
medium priorityThe homepage, /features, /customization, and /docs pages are boilerplate documentation. Replace with your actual product marketing.
src/app/page.tsx — Replace with your landing pagesrc/app/features/ — Delete or replace with your feature marketingsrc/app/customization/ — Delete (this page)src/app/docs/ — Replace with your product documentation
Project Structure
File structure overview
A bird's-eye view of the source directory to orient yourself quickly.
src/
├── app/
│ ├── (auth)/ # Unauthenticated layout
│ │ ├── sign-in/[[...sign-in]]/page.tsx
│ │ └── sign-up/[[...sign-up]]/page.tsx
│ ├── (dashboard)/ # Authenticated layout (Sidebar + Header)
│ │ ├── layout.tsx # Auth guard + sidebar layout
│ │ ├── loading.tsx # Shared dashboard loading skeleton
│ │ └── dashboard/
│ │ ├── page.tsx # /dashboard — overview
│ │ ├── analytics/ # /dashboard/analytics
│ │ ├── api-keys/ # /dashboard/api-keys
│ │ ├── changelog/ # /dashboard/changelog
│ │ ├── notifications/ # /dashboard/notifications
│ │ ├── profile/ # /dashboard/profile
│ │ ├── projects/ # /dashboard/projects
│ │ ├── settings/ # /dashboard/settings
│ │ └── team/ # /dashboard/team
│ ├── (admin)/ # Admin panel (authenticated)
│ │ ├── layout.tsx # Admin layout with admin sidebar
│ │ └── admin/
│ │ ├── page.tsx # /admin — overview
│ │ ├── users/ # /admin/users — user management
│ │ └── system/ # /admin/system — system health
│ ├── api/
│ │ └── webhooks/clerk/ # Clerk webhook receiver
│ ├── customization/ # /customization — this guide
│ ├── docs/ # /docs — documentation
│ ├── features/ # /features — feature reference
│ ├── layout.tsx # Root layout (Clerk, Providers)
│ ├── page.tsx # / — home / landing page
│ ├── error.tsx # Global error boundary
│ ├── loading.tsx # Root loading state
│ └── not-found.tsx # 404 page
├── components/
│ ├── animations/ # GSAP wrappers (FadeIn, StaggerChildren, etc.)
│ ├── layout/ # Header, Footer, Sidebar, MobileNav, etc.
│ ├── providers/ # Clerk + ThemeProvider wrapper
│ └── ui/ # shadcn/ui components
├── lib/
│ ├── db.ts # Prisma client singleton
│ └── utils.ts # cn() and other utilities
└── middleware.ts # Clerk auth middleware (route protection)FAQ
Customization FAQ
Start customizing
Fork the repo and build your product on this foundation. Use the feature registry for clean removals, or customize manually. The stack is solid — the content is yours to replace.