Essayer en local

Le portail fonctionne entièrement sur votre machine, avec le vrai parcours de connexion. Aucun compte Cloudflare, aucun email réel, aucun Docker.

Lancer

Node.js 22 ou plus récent, depuis apps/theme-hub :

npm ci
(cd ../../packages/core && npm ci)
npm run db:local
npm run dev

npm run dev construit l’interface puis lance le Worker sur http://localhost:8787.

Se connecter

L’interface s’ouvre en anglais (langue par défaut) ; le menu du compte permet de passer en français, ukrainien ou arabe.

1. Ouvrir http://localhost:8787.
2. Saisir [email protected] et demander un code.
3. Cliquer Read the local test code (« Lire le code de test local » en français), puis se connecter.

Seule la livraison de l’email est remplacée par une boîte locale. Cette boîte n’existe qu’en environnement local, sur une adresse localhost. En local, [email protected] est administrateur de la plateforme.

Essayer un thème

1. Créer une organisation.
2. Nouveau thème : importer theme/DWA.css (racine du dépôt). Le validateur et l’aperçu s’affichent ; le thème de référence passe sans erreur.
3. Enregistrer le brouillon, puis publier.
4. Dans VS Code, DWA : se connecter au portail avec http://localhost:8787, puis DWA : choisir un thème d’organisation.

Les données locales sont dans apps/theme-hub/.wrangler/, ignoré par Git.

Ne jamais déployer l’environnement local

L’environnement local utilise un secret de développement public. Aucun déploiement n’est configuré pour le moment ; il fera l’objet d’une procédure dédiée.

Architecture

Élément	Service	Rôle
API et interface	Cloudflare Workers + Static Assets	API web, API des extensions, interface React servie par le Worker
Base	Cloudflare D1 (SQLite)	Organisations, membres, groupes, thèmes, versions, rapports, sessions, journal
Fichiers	Cloudflare R2 ou stockage de l’organisation	CSS publiés
Authentification	Better Auth, dans le Worker	Codes email, SSO OIDC, sessions
Assistant	API Claude (facultatif)	Corrections proposées dans l’éditeur

Pas de serveur permanent ni de base PostgreSQL : en local, D1 et R2 sont simulés par Miniflare. Les tests simulent aussi S3, Azure, le fournisseur OIDC et l’API Claude : aucune requête ne part vers un service distant.