SOMMAIRE
🚀 PRÉSENTATION
"L'excellence industrielle dès le premier commit !"
Ce projet n'est pas simplement un squelette d'application, c'est un accélérateur de développement Angular 21 conçu pour les équipes exigeantes.
Il incarne une philosophie "Zéro Config - Maximum Quality".
Tout a été pré-configuré avec certains des outils les plus stricts du marché afin de se concentrer uniquement sur la valeur métier sans se soucier de la dette technique.
🔥 Pourquoi ce template ?
✨ Qualité :
Une config ESLint (flat-config) & Prettier stricte (mais aussi HTMLHint, StyleLint, SecretLint), couplée à SonarCloud pour un code propre, uniforme et maintenable.
🛡️ Sécurité :
Scans automatiques de vulnérabilités (Snyk), détection de secrets (GitLeaks) et analyse statique avancée (CodeQL).
⚡ Haute Performance :
Build ultra-rapide (Esbuild), serveur de développement quasi instantané (Vite) et gestionnaire de paquets optimisé et reproductible via (PNPM).
🧪 Tests Next-Gen :
Stratégie de tests unitaires modernisée propulsée par Vitest offrant une exécution instantanée et une compatibilité native avec l'écosystème Vite.
🚧 Gatekeeping Local :
Finis les commits cassés. Husky et lint-staged interceptent chaque commit pour formater, linter et vérifier les secrets sur les fichiers modifiés uniquement. La qualité est forcée à la source avant même d'arriver sur la CI.
🤖 CI/CD Ready :
Pipelines GitHub Actions complètes incluant tests, linting, documentations, audits de sécurité et déploiement.
🏷️ Packaging & Release Automatisés :
Fini la gestion manuelle des versions. Le template intègre Semantic Release pour calculer automatiquement le SemVer, générer le Changelog, créer la Release GitHub et publier les artefacts sur GitHub Packages.
🛠️ DX & Corepack :
Onboarding immédiat. Grâce à Corepack, le projet installe et utilise automatiquement la version stricte de PNPM définie dans le package.json. Fini les conflits de versions entre développeurs ou les installations globales.
♿ Accessibilité Native :
Conformité RGAA / WCAG intégrée dès le départ. Structure sémantique stricte, navigation au clavier et gestion du focus testées pour une inclusion totale.
📈 SEO & PWA Ready :
Maximisez votre visibilité. Un Service Meta dynamique gère vos balises <head> en temps réel selon les routes. Le tout est épaulé par une configuration native des fichiers sitemap.xml, robots.txt et manifest.json pour une indexation parfaite et une compatibilité mobile.
🗣️ Multi-langues :
I18n intégré par défaut via NGX-Translate permettant de gérer facilement les traductions et de séparer le contenu de la logique métier.
🎨 Design System & Mobile-First :
Conception intégralement pensée pour le mobile. Le Design System est entièrement variabilisé (mixins, couleurs, polices, espacements...) pour une personnalisation sans douleur.
🧩 Smart UI Kit :
Une bibliothèque de composants internes (Custom Form, Generic Input, Button, Link, ScrollToTop...) et des layouts (Public, Admin, Header, Footer, Nav...) prêts à l'emploi. Tous couverts à 100% par des tests.
🧠 Architecture :
Error Handler global, Interceptors, Guards d'authentification, une partie de l'application Public et Private ainsi qu'un Dashboard Admin fonctionnel sont déjà configurés. Tous couverts à 100% par des tests.
🛠️ Pipes & Directives :
Des outils essentiels comme des Directives (input-focus, input-trim, input-uppercase...) et des Pipes (date-format...) sont inclus. Tous couverts à 100% par des tests.
📘 Documentation :
Architecture documentée en temps réel. Compodoc génère une documentation technique complète, automatiquement déployée et hébergée sur GitHub Pages à chaque merge sur le code stable (branche main). Cette Compodoc est évidemment aussi disponible en environnement local !
📚 DOCUMENTATION
La documentation détaillée est disponible ici :
- 🏗 Architecture
- 🚀 Setup
- 💎 Qualité
- 🧪 Tests
- ⚙️ Configuration
- 🏷️ Build & Packaging
- 🤖 CICD
- 🎨 Styles
- 🗣️ Multi Langues
- ♿ Accessibilité
- 📈 SEO
- 📘 Documentation
- 🔧 Rules Reference
- 💡 FAQ & Erreurs
⚡ QUICK START
Requirements
| Angular | Node.js | TypeScript | RxJS |
|---|---|---|---|
21.0.x |
^20.19.0 || ^22.12.0 || ^24.0.0 |
>=5.9.0 || <=6.0.0 |
^6.5.3 || ^7.4.0 |
Etape 1 : Node.js
- Ce projet nécessite une version précise de NodeJS. Utilisez NVM
nvm install 22.12.0 nvm use 22.12.0
Etape 2 : Gestionnaire de paquets : PNPM & Corepack
Ce projet utilise Corepack (inclus dans NodeJS) pour garantir que tous les développeurs utilisent exactement la même version de PNPM (définie dans le package.json).
⚠️ Vous pouvez toutefois installer PNPM en global.
Installation & Démarrage
- Via Clone SSH
git clone git@github.com:EmmanuelLefevre/AngularTemplate.git cd AngularTemplate corepack enable pnpm install pnpm start
- Via Package