next-forge
# ▲ / next-forge **Production-grade Turborepo template for Next.js apps.** <div> <img src="https://img.shields.io/npm/dy/next-forge" alt="" /> <img src="https://img.shields.io/npm/v/next-forge" alt="" /> <img src="https://img.shields.io/github/license/vercel/next-forge" alt="" /> </div> ## Overview [next-forge](https://github.com/vercel/next-forge) is a production-grade [Turborepo](https://turborepo.com) template for [Next.js](https://nextjs.org/) apps. It's designed to be a comprehensive starting point for building SaaS applications, providing a solid, opinionated foundation with minimal configuration required. Built on a decade of experience building web applications, next-forge balances speed and quality to help you ship thoroughly-built products faster. ### Philosophy next-forge is built around five core principles: - **Fast** — Quick to build, run, deploy, and iterate on - **Cheap** — Free to start with services that scale with you - **Opinionated** — Integrated tooling designed to work together - **Modern** — Latest stable features with healthy community support - **Safe** — End-to-end type safety and robust security posture ## Demo Experience next-forge in action: - [Web](https://demo.next-forge.com) — Marketing website - [App](https://app.demo.next-forge.com) — Main application - [Storybook](https://storybook.demo.next-forge.com) — Component library - [API](https://api.demo.next-forge.com/health) — API health check ## Features next-forge comes with batteries included: ### Apps - **Web** — Marketing site built with Tailwind CSS and TWBlocks - **App** — Main application with authentication and database integration - **API** — RESTful API with health checks and monitoring - **Docs** — Documentation site powered by Mintlify - **Email** — Email templates with React Email - **Storybook** — Component development environment ### Packages - **Authentication** — Powered by [Clerk](https://clerk.com) - **Database** — Type-safe ORM with migrations - **Design System** — Comprehensive component library with dark mode - **Payments** — Subscription management via [Stripe](https://stripe.com) - **Email** — Transactional emails via [Resend](https://resend.com) - **Analytics** — Web ([Google Analytics](https://developers.google.com/analytics)) and product ([Posthog](https://posthog.com)) - **Observability** — Error tracking ([Sentry](https://sentry.io)), logging, and uptime monitoring ([BetterStack](https://betterstack.com)) - **Security** — Application security ([Arcjet](https://arcjet.com)), rate limiting, and secure headers - **CMS** — Type-safe content management for blogs and documentation - **SEO** — Metadata management, sitemaps, and JSON-LD - **AI** — AI integration utilities - **Webhooks** — Inbound and outbound webhook handling - **Collaboration** — Real-time features with avatars and live cursors - **Feature Flags** — Feature flag management - **Cron** — Scheduled job management - **Storage** — File upload and management - **Internationalization** — Multi-language support - **Notifications** — In-app notification system ## Getting Started ### Prerequisites - Node.js 20+ - [Bun](https://bun.sh) (or npm/yarn/pnpm) - [Stripe CLI](https://docs.stripe.com/stripe-cli) for local webhook testing ### Installation Create a new next-forge project: ```sh npx next-forge@latest init ``` ### Setup 1. Configure your environment variables 2. Set up required service accounts (Clerk, Stripe, Resend, etc.) 3. Run the development server For detailed setup instructions, read the [documentation](https://www.next-forge.com/docs). ## Structure next-forge uses a monorepo structure managed by Turborepo: ``` next-forge/ ├── apps/ # Deployable applications │ ├── web/ # Marketing website (port 3001) │ ├── app/ # Main application (port 3000) │ ├── api/ # API server │ ├── docs/ # Documentation │ ├── email/ # Email templates │ └── storybook/ # Component library └── packages/ # Shared packages ├── design-system/ ├── database/ ├── auth/ └── ... ``` Each app is self-contained and independently deployable. Packages are shared across apps for consistency and maintainability. ## Documentation Full documentation is available at [next-forge.com/docs](https://www.next-forge.com/docs), including: - Detailed setup guides - Package documentation - Migration guides for swapping providers - Deployment instructions - Examples and recipes ## Contributing We welcome contributions! See the [contributing guide](https://github.com/vercel/next-forge/blob/main/.github/CONTRIBUTING.md) for details. ## Contributors <a href="https://github.com/vercel/next-forge/graphs/contributors"> <img src="https://contrib.rocks/image?repo=vercel/next-forge" /> </a> Made with [contrib.rocks](https://contrib.rocks). ## License MIT