Installation

This guide helps you get the template running as a production-ready Next.js app. You can run locally for development and deploy to your preferred platform.

Requirements

• Node.js 18+ (recommended 20+)
• pnpm 9+ (or use npm/yarn)
• Git for version control

1. Install dependencies

From the project root:

pnpm install

If you prefer npm or yarn, use npm install or yarn instead.

2. Configure environment variables

Create a .env.local file at the project root for any secrets or runtime config. This template doesn’t require any by default, but you can add keys as needed:

# .env.local
# NEXT_PUBLIC_API_URL=https://api.example.com
# ANALYTICS_WRITE_KEY=xxx

3. Verify Next.js config

The project uses Next.js 15 with Turbopack. Key scripts in package.json:

{
  "scripts": {
    "dev": "next dev --turbopack",
    "build": "next build --turbopack",
    "start": "next start"
  }
}

4. Run the development server

pnpm dev

Open http://localhost:3000 to view the site. Edits in src/ will hot reload.

5. Project structure

1. src/app: App Router pages and layouts
2. src/components: UI components and primitives
3. src/templates.ts: Template registry
4. public/: Static assets

6. Styling

Tailwind CSS v4 is preconfigured. Global styles live in src/app/globals.css.

pnpm dlx tailwindcss --help # optional, shows tailwind v4 CLI

7. Linting

ESLint is configured. Run it locally to keep your codebase healthy:

pnpm lint

8. Build and run production

pnpm build
pnpm start

9. Deployment

Deploy anywhere that supports Next.js 15 Runtime—Vercel, Netlify, or your own Node server.

1. Vercel: push to Git and import the repo in Vercel. Framework should auto-detect.
2. Docker: create a container from the production build and run next start.

Using included templates

Browse templates under src/app/templates and templates/. The SaaS landing lives at /templates/saas-landing/preview.

1. Visit /templates to view available templates.
2. Open a template page and copy it into your own app route or customize components.

Troubleshooting

• Delete node_modules and lockfile, then reinstall: rm -rf node_modules pnpm-lock.yaml && pnpm install
• Ensure your Node version matches requirements: node -v
• Clear Next cache: rm -rf .next

You're all set

Start building your landing page. If you have questions, open the docs sidebar and check the guides.