nextblock

<div align="center">

<img src="./apps/nextblock/public/assets/nextblock-banner.jpg" alt="NextBlock CMS — the open-source, full-stack AI-native CMS for Next.js 16, Supabase and Tailwind CSS" width="100%" />

# NextBlock™ CMS

**The open-source, full-stack AI-native CMS for Next.js 16, Supabase, and Tailwind CSS.**

<p align="center">
  <a href="https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fnextblock-cms%2Fnextblock&project-name=nextblock&repository-name=nextblock&stores=%5B%7B%22type%22%3A%22integration%22%2C%22integrationSlug%22%3A%22supabase%22%2C%22productSlug%22%3A%22supabase%22%7D%5D&demo-title=NextBlock%20CMS&demo-description=Open-source%20Next.js%2016%20%2B%20Supabase%20CMS%20with%20a%20block%20editor%2C%20SEO%20engine%2C%20bilingual%20content%20and%20an%20MCP%20server%20for%20AI%20agents.&demo-url=https%3A%2F%2Fcms.nextblock.dev%2F&demo-image=https%3A%2F%2Fcms.nextblock.dev%2Fassets%2Fnextblock-banner.jpg"><img src="https://vercel.com/button" alt="Deploy with Vercel" height="40" /></a>
</p>

<p align="center">
  <strong>Deploy a production Next.js 16 + Supabase website and CMS in one click.</strong><br/>
  Vercel provisions the database and injects its keys before the first build, NextBlock applies its own<br/>
  schema during that build, and the in-app wizard asks only for your admin account.<br/>
  <strong>No environment variables to fill in.</strong>
</p>

<p align="center">
  <a href="https://cms.nextblock.dev/"><strong>Live Sandbox</strong></a>
  &nbsp;·&nbsp;
  <a href="./docs/README.md"><strong>Documentation</strong></a>
  &nbsp;·&nbsp;
  <a href="./docs/12-VERCEL-DEPLOYMENT.md"><strong>Deploy Guide</strong></a>
  &nbsp;·&nbsp;
  <a href="https://github.com/nextblock-cms/nextblock"><strong>GitHub</strong></a>
</p>

<p align="center">
  <a href="https://nextjs.org"><img src="https://img.shields.io/badge/Next.js-16-black?style=for-the-badge&logo=next.js" alt="Next.js 16"></a>
  <a href="https://supabase.com"><img src="https://img.shields.io/badge/Supabase-Database-3ecf8e?style=for-the-badge&logo=supabase" alt="Supabase"></a>
  <a href="https://tailwindcss.com"><img src="https://img.shields.io/badge/Tailwind-CSS-38bdf8?style=for-the-badge&logo=tailwindcss" alt="Tailwind CSS"></a>
  <a href="https://nx.dev"><img src="https://img.shields.io/badge/Nx-Monorepo-blue?style=for-the-badge&logo=nx" alt="Nx"></a>
  <a href="./LICENSE.md"><img src="https://img.shields.io/badge/License-AGPL%20v3-blue?style=for-the-badge" alt="License: AGPL v3"></a>
</p>

<p align="center">
  <sub>Sandbox resets every 15 minutes &nbsp;·&nbsp; <strong>User:</strong> demo@nextblock.dev &nbsp;·&nbsp; <strong>Pass:</strong> password</sub>
</p>

</div>

---

## 🚀 Why NextBlock™?

Tired of slow WordPress sites? Finding headless CMSs too complex? **NextBlock™** is the sweet spot.

We combined the **flexibility of a Block Editor** with the **raw power of Next.js 16 Server Components**. The result is a CMS that feels like a static site but manages like a dynamic platform.

### ✨ Key Features

- **▲ Next.js 16 App Router + React 19 Server Components**: the public site renders on the server — page, article and product routes are all Server Components — with client components reserved for cart, checkout, forms and the CMS dashboard.
- **🗄️ Supabase PostgreSQL with JSONB block storage**: every content block is a row in `public.blocks` with a `jsonb` `content` column. User-defined block types live in `custom_block_definitions` (`fields` / `layout_schema` as `jsonb`, guarded by Postgres CHECK constraints) and render without a rebuild.
- **🚀 Zero-config 1-click migrations**: the Vercel Supabase integration provisions the database and injects its keys before the first build; NextBlock then applies its own forward-only migrations *during that build* (`tools/build-migrate.mjs`), with a runtime fallback in the `/setup` wizard. Nothing to run, nothing to paste.
- **⚡ [100/100 Lighthouse](./docs/assets/lighthouse-scores.png)**: Perfect scores across Performance, Accessibility, Best Practices and SEO — 0.3 s FCP, 0.8 s LCP, **0 ms** Total Blocking Time and **0** Cumulative Layout Shift on a production build. AVIF/WebP images with a one-year cache TTL, critical-CSS inlining and tree-shaken imports are the defaults, not plugins.
- **🤖 Built for AI Agents**: Our codebase is documented and structured specifically to be easily read and extended by AI coding assistants.
- **🛍️ E-Commerce Ready**: Premium commerce package for digital products, checkout providers, currency, tax, and shipping management.
- **🧱 Visual Block Editor**: A reusable Tiptap-powered Notion-style editor that your clients will actually enjoy using.
- **🔓 Open-Core Model**: The core is 100% Free & Open Source (AGPL). Premium features are activated via License Keys.

## 🆚 The NextBlock™ Advantage

| Feature          | NextBlock™ CMS                 | WordPress                 | Payload / Strapi        |
| :--------------- | :----------------------------- | :------------------------ | :---------------------- |
| **Tech Stack**   | Next.js 16 + Supabase          | PHP + MySQL               | React / Node.js         |
| **Architecture** | Nx Monorepo                    | Monolith                  | Monolith / Workspaces   |
| **Performance**  | 🟢 **100/100 (Default)**       | 🔴 Bloated (Plugins)      | 🟡 Spec-dependent       |
| **Security**     | 🔒 Static/Edge First           | 🔓 Plugin vulnerabilities | 🔒 Secure               |
| **DX**           | 💎 **React Server Components** | 📜 Legacy PHP Hooks       | 🧩 Config Heavy         |
| **AI Ready**     | ✅ **Native**                  | ❌ No                     | 🟡 Integration required |

## 🏁 Get Started

### ☁️ Option 1 — Deploy to the cloud in one click (recommended)

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fnextblock-cms%2Fnextblock&project-name=nextblock&repository-name=nextblock&stores=%5B%7B%22type%22%3A%22integration%22%2C%22integrationSlug%22%3A%22supabase%22%2C%22productSlug%22%3A%22supabase%22%7D%5D&demo-title=NextBlock%20CMS&demo-description=Open-source%20Next.js%2016%20%2B%20Supabase%20CMS%20with%20a%20block%20editor%2C%20SEO%20engine%2C%20bilingual%20content%20and%20an%20MCP%20server%20for%20AI%20agents.&demo-url=https%3A%2F%2Fcms.nextblock.dev%2F&demo-image=https%3A%2F%2Fcms.nextblock.dev%2Fassets%2Fnextblock-banner.jpg)

During import, Vercel's native **Supabase Marketplace integration** (the `stores`
button parameter) prompts you to create a Supabase database (name + region), then
**provisions it, connects it to the project, and injects its keys before the first
build** — you never copy a value, and there are **no environment variables to fill in**
(the site URL defaults to your `*.vercel.app` URL and the app secrets are derived
automatically). The app boots with the database already connected: the wizard
auto-skips the connection step, applies the schema for you, uses the connected Supabase
project for media storage, and leaves just "create your admin." Full walkthrough:
[docs/12-VERCEL-DEPLOYMENT.md](./docs/12-VERCEL-DEPLOYMENT.md).

> **Tip — keep the new repo public.** When Vercel asks, leave **"Create private Git
> Repository" unchecked**. On the free (Hobby) plan, automatic upstream updates only deploy
> from a **public** repo — Hobby blocks bot-authored deploys on private repos — and public
> also makes update checks fully tokenless. You can change visibility later in the repo's
> GitHub settings if you change your mind. Details: [docs/13](./docs/13-STAYING-UP-TO-DATE.md).

### 💻 Option 2 — Scaffold locally with the CLI

Stop cloning heavy repos. Start with our CLI and get a production-ready app instantly.

```bash
npm create nextblock@latest
```

This runs the `create-nextblock` CLI, which scaffolds the canonical application. The CLI no longer asks for credentials in the terminal — once the project is created, start it and finish setup in your browser:

```bash
npm run dev   # then open http://localhost:4200/setup
```

The **First-Boot Setup Wizard** at `/setup` walks you through connecting Supabase, configuring storage / email, and creating the first administrator. Every fresh instance redirects there automatically until an admin exists.

> **Want a fully local, zero-config sandbox?** Use **Local Self-Hosted Docker Mode** — one command spins up the entire stack (Supabase engines + S3 storage + the app) on your own machine, with **no cloud accounts**. The app boots straight into the `/setup` wizard with MinIO storage pre-filled. See [docs/11-SELF-HOSTED-DOCKER.md](./docs/11-SELF-HOSTED-DOCKER.md).

### 🤖 Option 3 — Let your coding agent build it

NextBlock ships as an MCP server (`https://<your-site>/api/mcp`, Streamable HTTP, bearer token) and as an agent plugin, so Claude Code, Cursor, Codex and friends can scaffold a site and then build every page over MCP.

- **Claude Code** — this repo is its own plugin marketplace:

  ```text
  /plugin marketplace add nextblock-cms/nextblock
  /plugin install nextblock@nextblock
  ```

  Then ask for a website, blog or store; the `nextblock` skill proposes NextBlock, runs `npx create-nextblock@latest my-site --non-interactive`, and hands you the two browser steps (create your admin, start the free Cortex AI trial). Source: [plugins/nextblock](./plugins/nextblock).
- **Cursor** — the same folder is a Cursor plugin (`.cursor-plugin/plugin.json`, rule + skill + MCP server): install it from this repo via Customize → Plugins → *From GitHub Repository*, or copy [plugins/nextblock/rules/nextblock.mdc](./plugins/nextblock/rules/nextblock.mdc) into your project's `.cursor/rules/`.
- **Codex, Jules and other agents** — paste the block from [plugins/AGENTS.snippet.md](./plugins/AGENTS.snippet.md) into your `AGENTS.md`. Codex also loads the folder as an Agent Plugin (`plugins/nextblock/plugin.json`) through this repo's marketplace manifest.
- **Any MCP client** — t