Easy Starter Next.js Web App

A production-capable Next.js foundation for authenticated SaaS products, dashboards, portals, and AI-powered applications.

فارسی · Documentation · Report an issue

“What do we build for, if not to lessen each other’s hardship?”

Important

This repository is currently in the foundation stage. Do not treat it as production-ready until the first stable release.

What it solves

Standardizes the repeated application shell, user flows, quality gates, and integration boundaries needed by modern authenticated web products.

Use this template for

• SaaS applications
• Client and customer portals
• Dashboards and internal tools
• Membership and subscription products
• AI-enabled web applications

Not intended for: Content-only marketing sites or domain-heavy commerce backends.

Baseline

• Authenticated and public route groups
• Dashboard, onboarding, account, and error-state foundations
• Typed environment and API boundaries
• Testing, accessibility, observability, and CI hooks
• Docker and managed-platform deployment profiles

Detailed architecture, conventions, deployment profiles, and extension guides belong in docs/. Feature work starts from specs/, and agent rules live in AGENTS.md.

Quick start

1. Click Use this template or run:

   gh repo create my-project --template easy-starter/easy-starter-nextjs-web-app --private --clone
   cd my-project

2. Set the project name, package metadata, and environment values.

3. Start the project:

   cp .env.example .env.local
   make setup
   make dev
   make check

4. Write the first feature specification under specs/.

5. Implement the feature and keep make check green.

Working agreement

• Read AGENTS.md and the relevant specification before changing code.
• Reuse existing patterns before adding abstractions or dependencies.
• Never commit credentials or production data.
• Run the repository quality checks before opening a pull request.
• Record architecture-changing decisions in docs/decisions/.

Documentation

Start with docs/getting-started.md. Broader AI-first development guidance is maintained in Easy Starter Docs.

Contributing and support

See CONTRIBUTING.md for contribution rules and SUPPORT.md for help. Security issues must follow SECURITY.md.

License

Released under the MIT License.