Comment Configurer NextBlock™ : Guide Complet | NextBlock™ CMS: Developer-First AI Next.js Platform

Il existe deux bonnes facons de lancer NextBlock™ : cloner le monorepo complet si vous voulez toute la plateforme, ou partir du CLI si vous voulez aller vite. Dans les deux cas, vous retrouvez le meme modele editorial, le meme shell CMS et la meme base produit.

Choisissez votre chemin

Monorepo

Ideal pour les contributeurs, auteurs de plugins et equipes qui veulent travailler directement dans tous les packages partages.

Starter CLI

Ideal pour demarrer une app Next.js prete a deployer avec NextBlock™ deja integre.

Visuel NextBlock™ montrant le CMS, les blocs et les integrations qui arrivent ensemble — Quel que soit le chemin choisi, vous heritez du meme editeur de blocs, du meme shell CMS et du meme langage produit.

Chemin 1 : cloner le monorepo

Cette option est la meilleure si vous voulez tout le workspace Nx et chaque package interne disponible en local.

Vous obtenez

Le site public, l'app CMS, le code du CLI et les librairies partagees
Un acces direct a libs/ pour les blocs et modules personnalises
Les outils de workspace comme nx graph pour visualiser les dependances

Bon choix pour

Les mainteneurs et contributeurs coeur
Les equipes qui construisent des extensions sur mesure
Les agences qui veulent un controle complet de la plateforme

git clone https://github.com/nextblock-cms/nextblock.git
cd nextblock
npm install
npm run setup

L'assistant npm run setup cree .env.local, demande vos cles Supabase, peut brancher R2 et SMTP, lie le CLI Supabase, puis pousse le schema avec npm run db:push.

Puis lancez l'application :

npx nx serve nextblock

Commandes utiles dans le monorepo :

# Build de tous les packages
npm run all-builds

# Lint de l'application principale
npm run nx:lint:nextblock

# Regenerer les types base de donnees
npm run db:types

# Inspecter les relations du workspace
npx nx graph

Chemin 2 : utiliser le starter CLI

Si votre but est d'aller vite, le CLI vous donne une app Next.js autonome avec NextBlock™ deja integre.

npm create nextblock@latest mon-site
cd mon-site

Le CLI copie un template pret pour la production, remplace les imports workspace par les packages publies, et peut lancer la meme configuration initiale. Le resultat reste une app Next.js classique, sans dependance a Nx.

Configurez votre environnement dans .env.local :

NEXT_PUBLIC_SUPABASE_URL=your-project-url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
NEXT_PUBLIC_URL=http://localhost:3000

Poussez le schema puis demarrez :

npm run db:push
npm run dev

Conseil

Le chemin CLI est le moyen le plus rapide d'evaluer NextBlock™ avec votre propre modele de contenu avant de passer, si besoin, au workspace complet.

Activer les modules premium

Pour un projet genere via le CLI, le package commerce peut etre active avec une seule commande :

npx create-nextblock activate ecommerce

Cette commande injecte les wrappers pour /cms/orders, /cms/products, /checkout et l'API checkout, le tout protege par verifyPackageOnline() afin de garder les routes premium alignees avec la licence.

Deploiement

NextBlock™ se deploie comme une app Next.js standard. Publiez sur Vercel, Netlify ou tout hebergeur Node.js, puis configurez les variables serveur comme la cle service role Supabase, les cles Stripe et CRON_SECRET.