@sirdanoosh/boilerplate

Create a new Next.js App Router frontend with a clean, bilingual starter that already follows the conventions in this repository.

Install

npm create @sirdanoosh/boilerplate

or:

npx @sirdanoosh/boilerplate initial

What You Get

• Next.js App Router starter
• TypeScript
• Tailwind CSS v4
• shadcn/ui conventions
• lucide-react icons
• next-intl bilingual LTR/RTL setup
• axios-based API structure under src/api
• zustand for local and session state
• zod validation
• optional Playwright tests
• optional React Query, PWA, and bundle analyzer setup

Generated Structure

• src/app for routes and framework files
• src/views for composed screens
• src/api/services/<domain> for domain API code
• src/providers for app-level wrappers
• src/i18n for locale config and messages
• src/lib/auth for CIAM helpers

Included Commands

The generated app includes:

pnpm dev
pnpm lint
pnpm type-check
pnpm test
pnpm react-doctor
pnpm react-doctor:report

Notes

• The initializer asks for the project name, target directory, optional features, and environment values.
• The template is designed to be a practical starting point, not a scaffold full of throwaway starter text.
• The boilerplate package is published separately from the frontend scanner.