nextarter-tailwind

A highly opinionated, bleeding-edge Next.js template focused on developer experience, strict code quality, and performance.

---

🔋 Features

• 🚀 Next.js & React: Uses Next.js App Router and React 19.
• 🎨 Tailwind CSS v4: CSS-first styling with the latest engine.
• 🛠️ Biome: Single tool for linting and formatting (35x faster than Prettier/ESLint).
• 🏎️ Turborepo: Optimized build piping and caching.
• 📦 pnpm: Fast, disk-space-efficient package management.
• 🔍 SEO Optimized: Pre-configured next-sitemap and metadata handling.
• 🏗️ Architectural Integrity: Separates routing (app/) from implementation (lib/).
• 🤖 Agent-Friendly: Includes AGENTS.md to help AI coding assistants reason about the codebase.

---

🏗️ Architecture Overview

The project uses a Lib-Delegation pattern to keep the routing layer clean.

graph TD
    subgraph "Routing Layer"
        A[src/app] -->|Exports| B[Next.js Entry Points]
    end

    subgraph "Implementation Layer"
        B --> C[src/lib/pages]
        B --> D[src/lib/layout]
        C --> E[src/lib/components]
        D --> E
        E --> F[src/lib/styles]
    end

Loading

For more details, see SPEC.md.

---

🚀 Getting Started

1. Initialize

npx degit agustinusnathaniel/nextarter-tailwind <APP_NAME>
cd <APP_NAME>

2. Install Dependencies

pnpm install

3. Run Development Server

pnpm dev

Open http://localhost:3000 to see your app.

---

🛠️ Development Workflows

Task	Command
Lint & Format	pnpm biome:fix
Type Check	pnpm type:check
E2E Tests	pnpm test:e2e
Build	pnpm build
Release	pnpm release

Detailed contribution guidelines can be found in CONTRIBUTING.md.

---

📖 Documentation Index

• SPEC.md: Technical specification and invariants.
• CONTRIBUTING.md: Contribution workflow and standards.
• AGENTS.md: Guidance for AI IDEs and coding assistants.

---

📝 License

Distributed under the MIT License. See LICENSE for more information.

---

Built with ❤️ by @agstnsnathaniel