repository·main·Indexed 27 days ago
https://github.com/vercel/next-forgeA production-grade Turborepo template for Next.js applications designed for building SaaS products. It provides an opinionated foundation with integrated tooling for authentication (Clerk), payments (Stripe), email (Resend), and observability (Sentry). The template includes Geistdocs, a documentation template built with Next.js and Fumadocs featuring AI chat, GitHub Discussions integration, and MDX support.
The next-forge monorepo contains several deployable applications located in the /apps/ directory. Each app runs on a specific default port during local development:
| App | Port | Purpose |
|---|---|---|
app | 3000 | Main authenticated SaaS application |
web | 3001 | Marketing website with CMS and SEO |
api | 3002 | Serverless API for webhooks, cron jobs |
email | 3003 | React Email preview server |
docs | 3004 | Documentation site (Mintlify) |
storybook | 6006 | Design system component workshop |
studio | 3005 | Prisma Studio for database editing |
Geistdocs provides the following built-in capabilities for documentation sites:
next-forge is implemented using Tailwind CSS with the darkMode: 'class' strategy. This toggles dark mode by adding a dark class to the html element. The next-themes provider handles theme persistence and system preference detection. Third-party components like Clerk and Sonner are preconfigured to respect this theme setup.shadcn/ui. It includes the necessary fonts and higher-order components to ensure the Storybook environment matches the visual experience of your main application.next-config package provides pre-configured image optimization settings. It enables support for AVIF and WebP formats and includes remote patterns to allow secure loading of images from Clerk (e.g., user profile images).The web application in next-forge comes pre-integrated with several core packages to provide a production-ready marketing site:
@repo/design-system components, hooks, and utilities.cms package to power a type-safe blog.seo package for search engine optimization.analytics package to track visitor behavior.observability package for error capture and performance tracking.next-forge uses Next.js's built-in sitemap.ts functionality to automatically generate a sitemap during each build. The generation process aggregates routes from three primary sources:
app directory for valid routes, excluding directories starting with _ (private routes) or ( (route groups).blog.getPosts() from @repo/cms and generates URLs using the _slug field under the /blog/ path.legal.getPosts() from @repo/cms and generates URLs using the _slug field under the /legal/ path.Each entry in the resulting sitemap includes a full URL and a lastModified timestamp set to the current date.
next-config package includes a Prisma plugin designed to correctly handle Prisma during server-side builds within a Next.js monorepo setup.