Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (create-nss) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

create-nss

Scaffold a production-ready Next.js 15 + Strapi v5 + PostgreSQL project in seconds.

Usage

npx create-nss my-project

The interactive wizard guides you through:

  create-nss
  Next.js 15 · Strapi v5 · PostgreSQL · Turborepo

  1. Project
  ────────────────────────────────────────
? Project name (kebab-case) › my-project
? Description › A full-stack web application

  2. Domains
  ────────────────────────────────────────
? Frontend domain (local dev) › my-project.dev
? API domain (local dev) › api.my-project.dev

  4. Upload Provider
  ────────────────────────────────────────
? Where should Strapi store uploaded files?
❯ ImageKit
  AWS S3
  Local (filesystem)

  5. Email Provider
  ────────────────────────────────────────
? Which email provider should Strapi use?
❯ Brevo — Opkod France
  Nodemailer (SMTP)
  SendGrid
  Mailgun
  Sendmail (default)

  6. Strapi Plugins
  ────────────────────────────────────────
? Select additional Strapi plugins
◻ GraphQL
◻ Internationalization (i18n)
◻ SEO

Then start building:

cd my-project
docker compose up -d     # PostgreSQL + Traefik (local SSL)
yarn dev                 # Next.js + Strapi in parallel

What You Get

my-project/
├── apps/
│   ├── web/              # Next.js 15 (App Router, TypeScript, Tailwind)
│   └── api/              # Strapi v5 (TypeScript, PostgreSQL)
├── docker/
│   ├── Dockerfile.api    # Production Strapi image
│   ├── Dockerfile.web    # Production Next.js image
│   └── certs/            # Local SSL certificates (mkcert)
├── scripts/
│   ├── setup.sh          # Secrets generation + deps install
│   └── generate-certs.sh # Local SSL via mkcert or openssl
├── docker-compose.yml        # Dev: PostgreSQL + Traefik
├── docker-compose.prod.yml   # Prod: full stack + Let's Encrypt
├── turbo.json
└── .env                      # Auto-generated with secrets

Stack

Layer	Technology
Frontend	Next.js 15, TypeScript, Tailwind CSS v4
CMS / API	Strapi v5, TypeScript
Database	PostgreSQL 16
Monorepo	Yarn Workspaces + Turborepo
Reverse Proxy	Traefik v3 (local SSL + Let's Encrypt prod)
Deploy	Dokploy-ready Docker Compose

Available Providers

Upload

Provider	Package
ImageKit	`strapi-provider-upload-imagekit`
AWS S3	`@strapi/provider-upload-aws-s3`
Local	Built-in

Email

Provider	Package
Brevo (Opkod)	`@opkod-france/strapi-provider-email-brevo`
Nodemailer	`@strapi/provider-email-nodemailer`
SendGrid	`@strapi/provider-email-sendgrid`
Mailgun	`@strapi/provider-email-mailgun`
Sendmail	Built-in

Strapi Plugins

Plugin	Package
GraphQL	`@strapi/plugin-graphql`
i18n	`@strapi/plugin-i18n`
SEO	`@strapi/plugin-seo`

CLI Options

Usage: create-nss [options] [project-name]

Arguments:
  project-name    Project name (kebab-case)

Options:
  --skip-install  Skip dependency installation
  --skip-certs    Skip SSL certificate generation
  -h, --help      Display help

Local Development Domains

By default, projects get local .dev domains with Traefik + SSL:

Service	URL
Frontend	`https://{project-name}.dev`
Strapi Admin	`https://api.{project-name}.dev/admin`
Strapi API	`https://api.{project-name}.dev/api`
Traefik Dashboard	`http://localhost:8080`

Requires mkcert for trusted certificates (brew install mkcert).

Contributing

Commits follow Conventional Commits. Releases are automated via semantic-release.

feat: add Resend email provider    → minor release (1.x.0)
fix: correct S3 config template    → patch release (1.0.x)
feat!: change prompt flow          → major release (x.0.0)

License

MIT — Opkod France