Fraza branche dans un projet Next.js ordinaire les comptes, les rôles, une administration extensible, les courriels, les fichiers et les paiements. Conçu au Québec.

npx @fraza/start

Documentation · Installation · Modules

[!WARNING] Fraza est en version 0.x. Une nouvelle version mineure peut contenir un changement cassant.

Points forts

• Un back-office complet dès le départ. Connexion, inscription, invitations, utilisateurs, rôles et permissions, tableau de bord, mode sombre.
• Extensible sans toucher au core. Un module apporte ses tables, ses écrans, ses permissions et ses routes. Il s'installe avec npm et s'active par une variable.
• Les services de tous les projets. Routeur API avec CSRF et limitation du débit, courriels React Email, stockage compatible S3, paiements Stripe, tâches planifiées.
• La documentation dans le paquet. node_modules/@fraza/core/dist/docs/ porte la documentation de la version installée, lisible hors ligne, par vous comme par un agent.

Démarrage rapide

Dans un dossier vide, avec Node.js 20.12 ou plus et une base PostgreSQL 14 ou plus :

npx @fraza/start

Renseignez FRAZA_DATABASE_URL dans le .env.local créé, puis :

npx fraza-db init
npm run dev

Ouvrez http://localhost:3000/auth pour créer le premier compte, qui reçoit le rôle admin. Le détail est dans Installation.

Ajouter un module

npm i @fraza/module-pages

# .env.local
FRAZA_MODULE_PAGES=true

npx fraza-modules sync
npx fraza-db init

| Module | Paquet | Licence | |---|---|---| | Pages | @fraza/module-pages | MIT | | Posts | @fraza/module-posts | MIT | | Médias | @fraza/module-medias | MIT | | Formulaires | @fraza/module-forms | MIT | | Facturation | @fraza-pro/module-billing | Fraza Pro | | Rendez-vous | @fraza-pro/module-booking | Fraza Pro | | Fichiers | @fraza-pro/module-drive | Fraza Pro | | Licences | @fraza-pro/module-licenses | Fraza Pro |

Le core et les modules gratuits s'installent depuis npmjs, sans compte. Les modules Pro s'installent depuis https://registry.fraza.ca/, avec la clé du projet (fzk_…) dans son .npmrc.

Commandes

| Commande | Rôle | |---|---| | fraza-db | Créer, tester et supprimer les tables du core et des modules. | | fraza-modules | Régénérer les manifestes des modules, blocs et templates. | | fraza-doctor | Diagnostiquer le projet : variables manquantes, modules, paquets, vulnérabilités. | | fraza-update | Mettre à jour le core, les icônes et les modules en une commande. |

Chaque commande est détaillée dans la référence des CLI.

Documentation

| Section | Contenu | |---|---| | Découverte | Ce qu'est Fraza, sans rien installer. | | Démarrage | De l'installation au premier module, à lire dans l'ordre. | | Guides | Un cas d'usage par page. | | Référence | Chaque fonction, commande et variable d'environnement. | | Architecture | Principes, frontières serveur/client, sécurité, design system. | | Modules | Les modules officiels, gratuits et Pro : installation, configuration, API. |

Sécurité

N'ouvrez pas d'issue publique pour une faille. Écrivez à [email protected]. La politique complète est dans SECURITY.md.

Licence

MIT. Copyright (c) 2026 Fraza. Voir LICENSE. Les dépendances tierces sont listées dans THIRD-PARTY-NOTICES.md.

Le core et les modules Pages, Posts, Médias et Formulaires forment Fraza Libre. Les modules Facturation, Rendez-vous, Fichiers et Licences sont sous licence Fraza Pro : un abonnement annuel, Développeur (30 projets) ou Agence (illimité), sur compte.fraza.ca : voir Licence et propriété.