Guides de développement

Le site utilise Next.js avec l'App Router, React, TypeScript et Bootstrap 5 complété par une feuille de styles propre à BI3LYX. Les pages éditoriales sont générées à partir de données typées dans le dépôt.

app/

Routes, mises en page, métadonnées, sitemap, flux RSS et route de statut.

components/

Composants d'interface réutilisables, dont la navigation, les cartes et l'explorateur.

lib/

Données éditoriales typées, configuration du site et modèles de l'API future.

tests/

Tests de contenu, de navigation, de composants et de rendu des pages.

• npm install — installer les dépendances.
• npm run dev — lancer le serveur de développement.
• npm run typecheck — vérifier TypeScript sans émettre de fichiers.
• npm run lint — analyser le code avec ESLint.
• npm test — exécuter la suite de tests.
• npm run build — produire le build de production.
• npm start — démarrer le build Next.js.

Les pages de documentation et les actualités sont décrites par des blocs typés. Chaque nouvelle publication doit fournir un slug unique, un titre, une description, une date et un corps rédigé sans donnée non confirmée.

• Vérifier les liens internes et les métadonnées.
• Indiquer clairement les informations en préparation.
• Ne jamais publier de statistiques inventées ou de captures simulées.
• Faire relire les affirmations techniques avant publication.

• Conserver une couche d'accès serveur distincte des composants d'affichage.
• Configurer l'URL de l'API uniquement par variable d'environnement.
• Prévoir un délai d'attente et un état d'erreur explicite.
• Valider les schémas de réponse avant affichage.
• Ne jamais exposer une URL RPC, un secret ou une donnée de wallet.

• Aucune modification directe de l'infrastructure de production depuis le dépôt du site.
• Toute évolution doit passer le typage, le lint, les tests et le build.
• Les commits et déploiements requièrent l'autorisation du responsable du projet.
• Les binaires ne sont jamais publiés depuis le site sans vérification et signature.