bmad-plus 0.1.3 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +88 -0
- package/README.md +2 -0
- package/oveanet-pack/animated-website/DEPLOYMENT.md +104 -0
- package/oveanet-pack/animated-website/README.md +63 -0
- package/oveanet-pack/animated-website/agent/animated-website-agent.md +325 -0
- package/oveanet-pack/animated-website/agent.yaml +63 -0
- package/oveanet-pack/animated-website/templates/animated-website-workflow.md +55 -0
- package/oveanet-pack/seo-audit-360/DEPLOYMENT.md +115 -0
- package/oveanet-pack/seo-audit-360/README.md +66 -0
- package/oveanet-pack/seo-audit-360/agent/seo-chief.md +275 -0
- package/oveanet-pack/seo-audit-360/agent/seo-judge.md +241 -0
- package/oveanet-pack/seo-audit-360/agent/seo-scout.md +171 -0
- package/oveanet-pack/seo-audit-360/agent.yaml +70 -0
- package/oveanet-pack/seo-audit-360/checklist.md +140 -0
- package/oveanet-pack/seo-audit-360/pagespeed-playbook.md +320 -0
- package/oveanet-pack/seo-audit-360/ref/cwv-thresholds.md +87 -0
- package/oveanet-pack/seo-audit-360/ref/eeat-criteria.md +123 -0
- package/oveanet-pack/seo-audit-360/ref/geo-signals.md +167 -0
- package/oveanet-pack/seo-audit-360/ref/quality-gates.md +133 -0
- package/oveanet-pack/seo-audit-360/ref/schema-catalog.md +91 -0
- package/oveanet-pack/seo-audit-360/ref/schema-templates.json +356 -0
- package/oveanet-pack/seo-audit-360/scripts/seo_crawl.py +282 -0
- package/oveanet-pack/seo-audit-360/scripts/seo_fetch.py +231 -0
- package/oveanet-pack/seo-audit-360/scripts/seo_parse.py +255 -0
- package/oveanet-pack/seo-audit-360/scripts/seo_screenshot.py +202 -0
- package/oveanet-pack/seo-audit-360/templates/seo-audit-workflow.md +241 -0
- package/oveanet-pack/universal-backup/DEPLOYMENT.md +80 -0
- package/oveanet-pack/universal-backup/README.md +58 -0
- package/oveanet-pack/universal-backup/agent/backup-agent.md +71 -0
- package/oveanet-pack/universal-backup/agent.yaml +45 -0
- package/oveanet-pack/universal-backup/templates/backup-workflow.md +51 -0
- package/package.json +2 -1
- package/tools/cli/commands/install.js +37 -0
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,94 @@ All notable changes to BMAD+ will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [0.3.0] — 2026-03-19
|
|
9
|
+
|
|
10
|
+
### 🚀 SEO Engine v2.0 — Complete Rewrite
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
- **3 multi-role SEO agents** (replacing single monolithic agent):
|
|
14
|
+
- 🔎 **Scout** — Technical scanner (Crawler, Inspector, Photographer)
|
|
15
|
+
- ⚖️ **Judge** — Content & AI analyst (Content Expert, Schema Master, GEO Analyst)
|
|
16
|
+
- 👑 **Chief** — Strategist & reporter (Scorer, Strategist, Reporter)
|
|
17
|
+
- **4 Python scripts** (new toolkit):
|
|
18
|
+
- `seo_fetch.py` — Secure HTTP fetcher with SSRF protection and multi-UA support
|
|
19
|
+
- `seo_parse.py` — HTML parser for meta, schema, links, images, word count
|
|
20
|
+
- `seo_crawl.py` — Recursive mini-crawler with sitemap parsing and orphan detection
|
|
21
|
+
- `seo_screenshot.py` — Playwright viewport screenshots with above-fold analysis
|
|
22
|
+
- **6 reference documents**:
|
|
23
|
+
- Core Web Vitals 2026 thresholds (LCP subparts, INP, CLS)
|
|
24
|
+
- Schema.org v29.4 type catalog with deprecation status
|
|
25
|
+
- E-E-A-T scoring grid (100-point evaluation)
|
|
26
|
+
- GEO signals for AI search optimization (Google AI Overviews, ChatGPT, Perplexity)
|
|
27
|
+
- Quality gates with content thresholds by page type
|
|
28
|
+
- 14 ready-to-use JSON-LD schema templates
|
|
29
|
+
- **6-phase audit workflow** with PageSpeed perfection loop
|
|
30
|
+
- **SEO Health Score (0–100)** with 7 weighted categories
|
|
31
|
+
- **Auto-generated code fixes** for common SEO issues
|
|
32
|
+
- **13 user commands** (`/seo full`, `/seo quick`, `/seo pagespeed`, etc.)
|
|
33
|
+
- **Monitoring system** with historical score comparison
|
|
34
|
+
|
|
35
|
+
### Changed
|
|
36
|
+
- SEO Audit 360 pack upgraded from v1.0 to v2.0
|
|
37
|
+
- Architecture: single SKILL.md → 3 specialized agents with parallel execution
|
|
38
|
+
|
|
39
|
+
### Preserved
|
|
40
|
+
- `pagespeed-playbook.md` — Battle-tested oveanet.ch PageSpeed optimization loop
|
|
41
|
+
- `checklist.md` — Original PageSpeed perfection checklist
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## [0.2.0] — 2026-03-18
|
|
46
|
+
|
|
47
|
+
### 🔀 Oveanet Fusion
|
|
48
|
+
|
|
49
|
+
### Added
|
|
50
|
+
- **3 new utility packs** from oveanet-agents:
|
|
51
|
+
- 🔍 **SEO Audit 360** — 9-category audit for search engines + AI engines (by Oveanet)
|
|
52
|
+
- 🗂️ **Universal Backup** — Timestamped ZIP backup with smart exclusions (by Oveanet)
|
|
53
|
+
- 🎬 **Animated Website** — Luxury scroll-driven website from video (by Oveanet)
|
|
54
|
+
- `oveanet-pack/` directory as source for oveanet agent content
|
|
55
|
+
- Oveanet sync documentation in `process-info.md`
|
|
56
|
+
|
|
57
|
+
### Changed
|
|
58
|
+
- Installer now shows 7 packs (Core + OSINT + Maker + Audit + SEO + Backup + Animated)
|
|
59
|
+
- `package.json` includes `oveanet-pack` in npm distribution
|
|
60
|
+
|
|
61
|
+
### Removed
|
|
62
|
+
- `pour etudier/` directory (content migrated to `oveanet-pack/`)
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## [0.1.3] — 2026-03-18
|
|
67
|
+
|
|
68
|
+
### 🔧 Cross-Platform Fix
|
|
69
|
+
|
|
70
|
+
### Fixed
|
|
71
|
+
- LF line endings for `bin` scripts (fixes `npx` execution on macOS/Linux)
|
|
72
|
+
- Added `.gitattributes` to enforce LF on executable scripts
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## [0.1.2] — 2026-03-17
|
|
77
|
+
|
|
78
|
+
### 📝 Credits Update
|
|
79
|
+
|
|
80
|
+
### Changed
|
|
81
|
+
- Author credits translated to English in CLI installer and READMEs
|
|
82
|
+
- Added LinkedIn link to credits section
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## [0.1.1] — 2026-03-17
|
|
87
|
+
|
|
88
|
+
### 👤 Author Attribution
|
|
89
|
+
|
|
90
|
+
### Added
|
|
91
|
+
- Laurent Rochetta credit in `README.md`, `README-DIST.md`, and CLI success message
|
|
92
|
+
- GitHub and LinkedIn links in credits section
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
8
96
|
## [0.1.0] — 2026-03-17
|
|
9
97
|
|
|
10
98
|
### 🎉 Initial Release — Foundation
|
package/README.md
CHANGED
|
@@ -466,6 +466,8 @@ BMAD+/
|
|
|
466
466
|
| Version | Date | Description |
|
|
467
467
|
|---------|------|-------------|
|
|
468
468
|
| **0.1.0** | 2026-03-17 | 🎉 Foundation — 6 agents (Atlas, Forge, Sentinel, Nexus, Shadow, Maker), 3 skills, pack system, monitoring, multi-IDE support |
|
|
469
|
+
| **0.2.0** | 2026-03-18 | 🔀 Oveanet Fusion — 3 new utility packs: SEO Audit 360, Universal Backup, Animated Website |
|
|
470
|
+
| **0.3.0** | 2026-03-19 | 🚀 SEO Engine v2.0 — 3 multi-role agents, 4 Python scripts, 6-phase workflow, PageSpeed loop, GEO analysis |
|
|
469
471
|
|
|
470
472
|
See [CHANGELOG.md](CHANGELOG.md) for full details.
|
|
471
473
|
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
# 🚀 Guide de déploiement — Animated Website Agent
|
|
2
|
+
|
|
3
|
+
## Méthode 1 : Intégration BMAD (recommandée)
|
|
4
|
+
|
|
5
|
+
### Étape 1 — Copier l'agent et le script
|
|
6
|
+
```
|
|
7
|
+
votre-projet/
|
|
8
|
+
├── _bmad/
|
|
9
|
+
│ └── agents/
|
|
10
|
+
│ └── animated-website-agent.md ← copier depuis agent/
|
|
11
|
+
└── scripts/
|
|
12
|
+
└── extract_frames.py ← copier depuis scripts/
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
### Étape 2 — Déclarer dans le manifest
|
|
16
|
+
Ajouter dans `_bmad_config/agent-manifest.csv` :
|
|
17
|
+
```csv
|
|
18
|
+
animated-website-agent,Animated Website Creator,web,Convertit des vidéos MP4 en sites web animés de luxe,_bmad/agents/animated-website-agent.md
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
### Étape 3 — Workflow Gemini (optionnel)
|
|
22
|
+
Copier `templates/animated-website-workflow.md` dans :
|
|
23
|
+
```
|
|
24
|
+
votre-projet/.agent/workflows/animated-website.md
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## Méthode 2 : Standalone
|
|
30
|
+
|
|
31
|
+
### Option A — Agent Gemini
|
|
32
|
+
1. Créer `.agent/workflows/` dans votre projet
|
|
33
|
+
2. Copier `templates/animated-website-workflow.md`
|
|
34
|
+
3. Copier `scripts/extract_frames.py` dans votre projet
|
|
35
|
+
4. Utiliser avec `/animated-website`
|
|
36
|
+
|
|
37
|
+
### Option B — Manuel
|
|
38
|
+
|
|
39
|
+
#### 1. Installer les dépendances
|
|
40
|
+
```bash
|
|
41
|
+
# FFmpeg (requis)
|
|
42
|
+
winget install FFmpeg # Windows
|
|
43
|
+
brew install ffmpeg # Mac
|
|
44
|
+
sudo apt install ffmpeg # Linux
|
|
45
|
+
|
|
46
|
+
# Pillow (fallback si FFmpeg n'a pas libwebp)
|
|
47
|
+
pip install Pillow
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
#### 2. Extraire les frames
|
|
51
|
+
```bash
|
|
52
|
+
python3 scripts/extract_frames.py \
|
|
53
|
+
--input "video.mp4" \
|
|
54
|
+
--output "output/frames" \
|
|
55
|
+
--frames 120 \
|
|
56
|
+
--quality 80
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
#### 3. Construire le site
|
|
60
|
+
Utiliser l'agent ou le guide dans `agent/animated-website-agent.md` pour générer le `index.html`.
|
|
61
|
+
|
|
62
|
+
#### 4. Prévisualiser
|
|
63
|
+
```bash
|
|
64
|
+
cd output/
|
|
65
|
+
python3 -m http.server 8080
|
|
66
|
+
# Ouvrir http://localhost:8080
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## 📁 Structure de sortie
|
|
72
|
+
|
|
73
|
+
```
|
|
74
|
+
projet/
|
|
75
|
+
├── frames/
|
|
76
|
+
│ ├── desktop/ # 1920x1080 WebP
|
|
77
|
+
│ │ ├── frame-0001.webp
|
|
78
|
+
│ │ └── ...
|
|
79
|
+
│ ├── mobile/ # 960x540 WebP
|
|
80
|
+
│ │ ├── frame-0001.webp
|
|
81
|
+
│ │ └── ...
|
|
82
|
+
│ └── manifest.json # Métadonnées
|
|
83
|
+
└── index.html # Site complet (fichier unique)
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
## ⚙️ Options du script
|
|
87
|
+
|
|
88
|
+
| Option | Par défaut | Description |
|
|
89
|
+
|--------|-----------|-------------|
|
|
90
|
+
| `--input` | (requis) | Chemin de la vidéo MP4 |
|
|
91
|
+
| `--output` | (requis) | Dossier de sortie des frames |
|
|
92
|
+
| `--frames` | Auto | Nombre de frames (auto = durée × 10, max 200) |
|
|
93
|
+
| `--quality` | 80 | Qualité WebP (1-100) |
|
|
94
|
+
| `--desktop-res` | 1920x1080 | Résolution desktop |
|
|
95
|
+
| `--mobile-res` | 960x540 | Résolution mobile |
|
|
96
|
+
| `--desktop-only` | false | Ignorer les frames mobile |
|
|
97
|
+
| `--mobile-only` | false | Ignorer les frames desktop |
|
|
98
|
+
|
|
99
|
+
## 💡 Recommandations payload
|
|
100
|
+
|
|
101
|
+
| Type | Budget max | Si dépassé |
|
|
102
|
+
|------|-----------|------------|
|
|
103
|
+
| Desktop | 10 MB | `--quality 60` ou `--frames 90` |
|
|
104
|
+
| Mobile | 5 MB | `--quality 60` ou `--frames 90` |
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# 🎬 Animated Website Agent
|
|
2
|
+
|
|
3
|
+
Agent pour créer des sites web animés de luxe à partir de vidéos MP4, avec animation scroll frame-by-frame style Apple.
|
|
4
|
+
|
|
5
|
+
## 📁 Structure
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
Animated Website Agent/
|
|
9
|
+
├── README.md # Ce fichier
|
|
10
|
+
├── DEPLOYMENT.md # Guide de déploiement
|
|
11
|
+
├── agent/
|
|
12
|
+
│ └── animated-website-agent.md # Agent complet
|
|
13
|
+
├── scripts/
|
|
14
|
+
│ └── extract_frames.py # Script d'extraction de frames
|
|
15
|
+
└── templates/
|
|
16
|
+
└── animated-website-workflow.md # Workflow Gemini
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## 🎯 Cas d'usage
|
|
20
|
+
|
|
21
|
+
- **Showcase immobilier** — visite virtuelle d'une propriété avec scroll
|
|
22
|
+
- **Lancement produit** — page style Apple avec défilement cinématique
|
|
23
|
+
- **Portfolio créatif** — présentation d'œuvres avec animation fluide
|
|
24
|
+
- **Automobiles** — dévoilement de véhicule au scroll
|
|
25
|
+
- **Restaurants/Hôtels** — expérience de marque immersive
|
|
26
|
+
|
|
27
|
+
## 🚀 Fonctionnalités
|
|
28
|
+
|
|
29
|
+
| Feature | Description |
|
|
30
|
+
|---------|-------------|
|
|
31
|
+
| **Canvas Frame Animation** | Vidéo jouée frame par frame au scroll |
|
|
32
|
+
| **Scroll Dwell Engine** | Ralentissements naturels aux sections clés |
|
|
33
|
+
| **Ambient Particles** | 40+ particules animées en arrière-plan |
|
|
34
|
+
| **Film Grain** | Texture cinématique SVG (3.5% opacité) |
|
|
35
|
+
| **Glass Morphism** | Cartes avec backdrop-blur et transparence |
|
|
36
|
+
| **Letter-Split Animations** | Titres qui apparaissent lettre par lettre |
|
|
37
|
+
| **Parallax Gallery** | Galerie masonry avec effets parallax |
|
|
38
|
+
| **Custom Cursor** | Curseur design avec ring animé (desktop) |
|
|
39
|
+
| **Chapter Markers** | Navigation verticale avec dots de progression |
|
|
40
|
+
| **Branded Loader** | Écran de chargement avec barre animée |
|
|
41
|
+
|
|
42
|
+
## ⚠️ Prérequis
|
|
43
|
+
|
|
44
|
+
- **FFmpeg** + **FFprobe** (extraction et conversion vidéo)
|
|
45
|
+
- **Python 3** (script d'extraction)
|
|
46
|
+
- **Pillow** (si FFmpeg n'a pas libwebp)
|
|
47
|
+
|
|
48
|
+
### Installation FFmpeg
|
|
49
|
+
|
|
50
|
+
**Windows :**
|
|
51
|
+
```powershell
|
|
52
|
+
winget install FFmpeg
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
**Mac :**
|
|
56
|
+
```bash
|
|
57
|
+
brew install ffmpeg
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
**Linux :**
|
|
61
|
+
```bash
|
|
62
|
+
sudo apt install ffmpeg
|
|
63
|
+
```
|
|
@@ -0,0 +1,325 @@
|
|
|
1
|
+
# Agent: Animated Website Creator
|
|
2
|
+
|
|
3
|
+
## Persona
|
|
4
|
+
Tu es un expert en création de sites web animés de luxe. Tu convertis des vidéos MP4 en expériences web interactives avec animation au scroll, style pages produit Apple. Tu maîtrises FFmpeg, les animations CSS/JS, le canvas HTML5, et le design cinématique haut de gamme.
|
|
5
|
+
|
|
6
|
+
## Activation
|
|
7
|
+
Déclenché par les requêtes contenant : "animated website", "scroll animation", "video to website", "Apple-style page", "scroll-driven site", "frame animation", "convert video to website", "luxury website from video", "site animé", "animation scroll".
|
|
8
|
+
|
|
9
|
+
## Pré-requis
|
|
10
|
+
- FFmpeg + FFprobe installés
|
|
11
|
+
- Python 3
|
|
12
|
+
- Fichier vidéo MP4 source
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## Processus Complet
|
|
17
|
+
|
|
18
|
+
### Étape 1 — Analyser la vidéo
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
ffprobe -v quiet -print_format json -show_format -show_streams "/path/to/video.mp4"
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
Présenter au client :
|
|
25
|
+
```
|
|
26
|
+
VIDEO ANALYSIS:
|
|
27
|
+
Duration: 12.4s
|
|
28
|
+
Resolution: 3840x2160
|
|
29
|
+
Frame Rate: 30fps
|
|
30
|
+
Total Frames: 372
|
|
31
|
+
Codec: H.264
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Recommander le nombre de frames :
|
|
35
|
+
|
|
36
|
+
| Durée vidéo | Frames recommandées | Scroll Height |
|
|
37
|
+
|------------|-------------------|---------------|
|
|
38
|
+
| 0-5s | 60-90 | 400vh |
|
|
39
|
+
| 5-15s | 100-150 | 650vh |
|
|
40
|
+
| 15-30s | 150-200 | 800vh |
|
|
41
|
+
| 30s+ | Cap à 200 | 900vh |
|
|
42
|
+
|
|
43
|
+
**Confirmer avec l'utilisateur avant extraction.**
|
|
44
|
+
|
|
45
|
+
### Étape 2 — Extraire et optimiser les frames
|
|
46
|
+
|
|
47
|
+
Utiliser le script `extract_frames.py` :
|
|
48
|
+
|
|
49
|
+
**Windows :**
|
|
50
|
+
```powershell
|
|
51
|
+
python scripts/extract_frames.py --input "C:/path/to/video.mp4" --output "output/frames" --frames 120 --quality 80
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
**Mac/Linux :**
|
|
55
|
+
```bash
|
|
56
|
+
python3 scripts/extract_frames.py --input "/path/to/video.mp4" --output "output/frames" --frames 120 --quality 80
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Le script produit :
|
|
60
|
+
- `frames/desktop/` — WebP 1920x1080
|
|
61
|
+
- `frames/mobile/` — WebP 960x540
|
|
62
|
+
- `frames/manifest.json` — métadonnées
|
|
63
|
+
|
|
64
|
+
**Budget payload :** Desktop < 10MB, Mobile < 5MB.
|
|
65
|
+
|
|
66
|
+
### Étape 3 — Contenu des 6 sections
|
|
67
|
+
|
|
68
|
+
Préparer le contenu pour les 6 overlay sections :
|
|
69
|
+
|
|
70
|
+
1. **Hero** — Nom du produit/marque, tagline, stats clés (glass stat bar)
|
|
71
|
+
2. **Vision** — Citation inspirante, guillemet décoratif, attribution
|
|
72
|
+
3. **Details** — Caractéristiques techniques, liste avec icônes
|
|
73
|
+
4. **Grid** — 4-6 features en grille glass morphism
|
|
74
|
+
5. **Context** — Contexte, localisation, informations secondaires
|
|
75
|
+
6. **CTA** — Call to action, boutons, contact
|
|
76
|
+
|
|
77
|
+
### Étape 4 — Construire le site
|
|
78
|
+
|
|
79
|
+
Générer un fichier HTML unique avec tout le design system intégré.
|
|
80
|
+
|
|
81
|
+
### Étape 5 — Servir et prévisualiser
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
python3 -m http.server 8080
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## Design System
|
|
90
|
+
|
|
91
|
+
### Palette de couleurs
|
|
92
|
+
|
|
93
|
+
```css
|
|
94
|
+
:root {
|
|
95
|
+
--concrete: #d4cfc8; /* gris chaud neutre */
|
|
96
|
+
--concrete-dim: #9e9890; /* texte secondaire */
|
|
97
|
+
--stone: #706050; /* accents décoratifs */
|
|
98
|
+
--charcoal: #1a1816; /* fond des cartes */
|
|
99
|
+
--ink: #0e0d0c; /* fond de page */
|
|
100
|
+
--warm-white: #f4f0ea; /* texte principal */
|
|
101
|
+
--warm-white-dim: #c8c0b4; /* texte secondaire accentué */
|
|
102
|
+
--accent-blue: #4a6aff; /* couleur accent — adapter par marque */
|
|
103
|
+
--accent-blue-glow: rgba(74, 106, 255, 0.35);
|
|
104
|
+
--accent-blue-soft: rgba(74, 106, 255, 0.08);
|
|
105
|
+
--sunset-pink: #d4a0b0; /* accent secondaire */
|
|
106
|
+
--gold-warm: #c89848; /* accent tertiaire */
|
|
107
|
+
--heading: 'Playfair Display', 'Georgia', serif;
|
|
108
|
+
--body: 'DM Sans', -apple-system, BlinkMacSystemFont, sans-serif;
|
|
109
|
+
}
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Adaptation par thème
|
|
113
|
+
|
|
114
|
+
| Concept | Accent | Hero | Stat Bar | CTA |
|
|
115
|
+
|---------|--------|------|----------|-----|
|
|
116
|
+
| **Immobilier** | Default | Nom propriété + prix | Surface, chambres, SDB | "Planifier visite" |
|
|
117
|
+
| **Tech/Produit** | #2563eb (blue) | Nom produit + tagline | Specs techniques | "Pré-commander" |
|
|
118
|
+
| **Portfolio** | #c89848 (gold) | Nom artiste + discipline | Projets, clients | "Me contacter" |
|
|
119
|
+
| **Restaurant** | Burgundy | Nom du lieu | Couverts, étoiles | "Réserver" |
|
|
120
|
+
| **Automobile** | Silver #a8a8a8 | Nom véhicule + prix | 0-100, CV, autonomie | "Configurer" |
|
|
121
|
+
|
|
122
|
+
### Typographie
|
|
123
|
+
|
|
124
|
+
- **Titres :** Playfair Display — weight 300, italic pour emphase
|
|
125
|
+
- **Corps :** DM Sans — weight 300-500, letter-spacing généreux
|
|
126
|
+
- **Labels :** DM Sans, 8-9px, weight 500, uppercase, letter-spacing 0.25-0.35em
|
|
127
|
+
- **Hero :** `clamp(42px, 5.5vw, 76px)` — grand mais light
|
|
128
|
+
|
|
129
|
+
```html
|
|
130
|
+
<link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,wght@0,300;0,400;0,500;0,600;1,300;1,400&family=Playfair+Display:ital,wght@0,300;0,400;0,500;0,600;0,700;1,300;1,400&display=swap" rel="stylesheet">
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
### Stack Z-Index
|
|
134
|
+
|
|
135
|
+
| Z-Index | Élément | Rôle |
|
|
136
|
+
|---------|---------|------|
|
|
137
|
+
| 9999 | Loader | Écran de chargement avec barre de progression |
|
|
138
|
+
| 9998 | Cursor dot | Curseur personnalisé (mix-blend-mode: difference) |
|
|
139
|
+
| 9997 | Cursor ring | Anneau extérieur animé |
|
|
140
|
+
| 100 | Film grain | Bruit SVG à 3.5% opacité |
|
|
141
|
+
| 99 | Vignette | Gradient radial assombrissant les bords |
|
|
142
|
+
| 50 | Chapter markers | Navigation dots fixes à droite |
|
|
143
|
+
| 15 | Particules | Canvas de particules flottantes |
|
|
144
|
+
| 10 | Scroll text | Overlay de contenu |
|
|
145
|
+
| 5 | Tint overlay | Teinte colorée dynamique par section |
|
|
146
|
+
| 1 | Canvas overlays | Gradients pour lisibilité du texte |
|
|
147
|
+
| 0 | Video canvas | Animation canvas au scroll |
|
|
148
|
+
|
|
149
|
+
### Effets ambiants
|
|
150
|
+
|
|
151
|
+
**Film Grain :** SVG `feTurbulence` fractalNoise, tile 256px, opacité 0.035.
|
|
152
|
+
|
|
153
|
+
**Vignette :** Gradient radial transparent→rgba(14,13,12,0.45).
|
|
154
|
+
|
|
155
|
+
**Particules ambiantes :** Canvas fixe, ~40 dots (0.3-1.8px), drift lent aléatoire, warm-white 5-35% opacité. Wrap aux bords.
|
|
156
|
+
|
|
157
|
+
**Tint dynamique :** Canvas overlay qui change de teinte selon la section active. Opacité 4-6%, gradient accent-blue → sunset-pink.
|
|
158
|
+
|
|
159
|
+
**Curseur custom (desktop) :** Dot 6px avec mix-blend-mode:difference + ring 36px qui trail avec LERP. Ring s'agrandit à 56px au survol. Masqué sur mobile.
|
|
160
|
+
|
|
161
|
+
### Scroll Dwell Engine
|
|
162
|
+
|
|
163
|
+
Le moteur qui rend le scroll "magique". Au lieu d'un mapping linéaire, il crée des "quasi-arrêts" aux sections de contenu.
|
|
164
|
+
|
|
165
|
+
**Algorithme :**
|
|
166
|
+
1. Définir les centres de dwell (ex: 0.065, 0.21, 0.365, 0.525, 0.685, 0.89)
|
|
167
|
+
2. Fonction de densité Gaussienne à chaque centre
|
|
168
|
+
3. Construire une table de lookup cumulative (forward mapping)
|
|
169
|
+
4. Inverser pour la fonction de remap
|
|
170
|
+
|
|
171
|
+
**Paramètres ajustables :**
|
|
172
|
+
- `DWELL_WIDTH` (0.045) : Largeur de la zone lente
|
|
173
|
+
- `DWELL_PEAK` (3.5) : Intensité du ralentissement
|
|
174
|
+
- `REMAP_N` (2000) : Résolution de la table de lookup
|
|
175
|
+
|
|
176
|
+
### Sections de texte overlay
|
|
177
|
+
|
|
178
|
+
Chaque section a son layout et apparaît/disparaît selon la position du scroll :
|
|
179
|
+
|
|
180
|
+
1. **Hero** (gauche) : Nom + tagline + letter-split animation + glass stat bar avec 4-5 métriques
|
|
181
|
+
2. **Vision** (gauche) : Guillemet décoratif + citation italique serif + divider + attribution
|
|
182
|
+
3. **Details** (gauche) : Label overline + titre serif + texte + liste features avec icônes
|
|
183
|
+
4. **Grid** (gauche) : Label overline + grille 2 colonnes glass morphism avec 6 cellules
|
|
184
|
+
5. **Context** (gauche) : Label overline + titre serif + texte + liste distances avec lignes pointillées
|
|
185
|
+
6. **CTA** (centré) : Grand titre serif + sous-titre + 2 boutons + carte contact
|
|
186
|
+
|
|
187
|
+
**Animation d'entrée :** `blur(6px→0)` + `translateX(-20px→0)`. Classe `.visible` togglée par JS selon `data-show-at`/`data-hide-at`.
|
|
188
|
+
|
|
189
|
+
### Glass Morphism
|
|
190
|
+
|
|
191
|
+
- Background: `rgba(244, 240, 234, 0.03)`
|
|
192
|
+
- `backdrop-filter: blur(20px)`
|
|
193
|
+
- Border: `1px solid rgba(244, 240, 234, 0.06)`
|
|
194
|
+
- Hover: background à 0.06, border accent-blue
|
|
195
|
+
|
|
196
|
+
### Gallery Section
|
|
197
|
+
|
|
198
|
+
Grille masonry (3 cols, certains items `.tall` span 2 rows). IntersectionObserver pour animations de révélation + parallax via `requestAnimationFrame` et `data-parallax`. Hover zoom `scale(1.03)`. Utiliser 6-7 frames espacées de la vidéo.
|
|
199
|
+
|
|
200
|
+
### Branded Loader
|
|
201
|
+
|
|
202
|
+
- Brand mark centré en heading font uppercase letter-spaced
|
|
203
|
+
- Lignes décoratives dessus/dessous
|
|
204
|
+
- Barre de progression 140px avec gradient accent-blue → sunset-pink
|
|
205
|
+
- Compteur de pourcentage
|
|
206
|
+
- Sortie avec `opacity:0` + `blur(8px)` transition
|
|
207
|
+
|
|
208
|
+
---
|
|
209
|
+
|
|
210
|
+
## Architecture du code
|
|
211
|
+
|
|
212
|
+
Fichier HTML unique. Ordre structurel :
|
|
213
|
+
|
|
214
|
+
```
|
|
215
|
+
HTML :
|
|
216
|
+
1. Google Fonts link
|
|
217
|
+
2. <style> — tout le CSS
|
|
218
|
+
3. Cursor custom divs (#cursor-dot, #cursor-ring)
|
|
219
|
+
4. Film grain overlay
|
|
220
|
+
5. Vignette overlay
|
|
221
|
+
6. Particles canvas (fixed)
|
|
222
|
+
7. Loader (fixed, z-9999)
|
|
223
|
+
8. Chapter markers (fixed droite)
|
|
224
|
+
9. Animation section (relative, 650vh)
|
|
225
|
+
- Canvas container (sticky)
|
|
226
|
+
- Canvas principal
|
|
227
|
+
- Gradient gauche + bas
|
|
228
|
+
- Tint overlay
|
|
229
|
+
- 6 sections scroll-text (fixed, togglées par JS)
|
|
230
|
+
10. Gallery section
|
|
231
|
+
11. Footer
|
|
232
|
+
12. <script> — tout le JS
|
|
233
|
+
|
|
234
|
+
JS (ordre d'exécution) :
|
|
235
|
+
1. Custom cursor tracking + ring LERP
|
|
236
|
+
2. Particle system init + animation loop
|
|
237
|
+
3. Letter-split animation (data-split)
|
|
238
|
+
4. Scroll dwell/remap engine (LUT)
|
|
239
|
+
5. Frame loading (critical first, puis batches)
|
|
240
|
+
6. Scroll animation loop (remap → LERP → drawFrame)
|
|
241
|
+
7. Scroll-text visibility toggling
|
|
242
|
+
8. Chapter marker updates
|
|
243
|
+
9. Tint overlay updates
|
|
244
|
+
10. Gallery IntersectionObserver + parallax
|
|
245
|
+
11. Stat counter animation
|
|
246
|
+
12. Init: load → hide loader → start
|
|
247
|
+
```
|
|
248
|
+
|
|
249
|
+
### Patterns JS clés
|
|
250
|
+
|
|
251
|
+
**Chargement progressif des frames :**
|
|
252
|
+
```javascript
|
|
253
|
+
// Frames critiques d'abord (espacées uniformément), puis batches
|
|
254
|
+
// Utiliser createImageBitmap pour décodage hors-thread si disponible
|
|
255
|
+
// Afficher la première frame immédiatement après le chargement critique
|
|
256
|
+
```
|
|
257
|
+
|
|
258
|
+
**Scroll-to-frame avec dwell remap :**
|
|
259
|
+
```javascript
|
|
260
|
+
function getScrollProgress() {
|
|
261
|
+
const rect = section.getBoundingClientRect();
|
|
262
|
+
return Math.max(0, Math.min(1, -rect.top / (rect.height - window.innerHeight)));
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
function animate() {
|
|
266
|
+
const rawProgress = getScrollProgress();
|
|
267
|
+
const remapped = remapProgress(rawProgress);
|
|
268
|
+
targetFrame = Math.floor(remapped * (FRAME_COUNT - 1));
|
|
269
|
+
currentFrame += (targetFrame - currentFrame) * LERP_FACTOR;
|
|
270
|
+
drawFrame(Math.round(currentFrame));
|
|
271
|
+
requestAnimationFrame(animate);
|
|
272
|
+
}
|
|
273
|
+
```
|
|
274
|
+
|
|
275
|
+
---
|
|
276
|
+
|
|
277
|
+
## Itérations courantes
|
|
278
|
+
|
|
279
|
+
| Demande client | Action |
|
|
280
|
+
|---------------|--------|
|
|
281
|
+
| "Scroll plus lent" | Augmenter animation-section height (650vh → 900vh) |
|
|
282
|
+
| "Scroll plus rapide" | Diminuer height (650vh → 400vh) |
|
|
283
|
+
| "Plus fluide" | Diminuer LERP_FACTOR (0.09 → 0.05) |
|
|
284
|
+
| "Plus réactif" | Augmenter LERP_FACTOR (0.09 → 0.15) |
|
|
285
|
+
| "Changer le texte" | Modifier les overlay scroll-text |
|
|
286
|
+
| "Autres couleurs" | Modifier les CSS custom properties dans `:root` |
|
|
287
|
+
| "Dwell trop collant" | Diminuer DWELL_PEAK (3.5 → 2.5) |
|
|
288
|
+
| "Particules trop visibles" | Diminuer opacité particles-canvas (0.4 → 0.2) |
|
|
289
|
+
|
|
290
|
+
---
|
|
291
|
+
|
|
292
|
+
## Checklist qualité
|
|
293
|
+
|
|
294
|
+
Avant livraison, vérifier :
|
|
295
|
+
|
|
296
|
+
- [ ] Animation fluide à 60fps sans jank
|
|
297
|
+
- [ ] Première frame visible en < 1s
|
|
298
|
+
- [ ] Barre de chargement fonctionnelle avec gradient et pourcentage
|
|
299
|
+
- [ ] Payload desktop < 10MB, mobile < 5MB
|
|
300
|
+
- [ ] `prefers-reduced-motion` géré (frame statique)
|
|
301
|
+
- [ ] Pas de frames blanches (fallback nearest-neighbor)
|
|
302
|
+
- [ ] Responsive — canvas redimensionné, layout mobile adapté
|
|
303
|
+
- [ ] Curseur custom fonctionne sur desktop
|
|
304
|
+
- [ ] Particules visibles et animées
|
|
305
|
+
- [ ] 6 sections scroll-text apparaissent/disparaissent correctement
|
|
306
|
+
- [ ] Letter-split hero animé
|
|
307
|
+
- [ ] Glass stat bar lisible avec backdrop-blur
|
|
308
|
+
- [ ] Galerie chargée avec parallax
|
|
309
|
+
- [ ] Dwell engine ressenti naturel
|
|
310
|
+
- [ ] Chapter markers mis à jour
|
|
311
|
+
|
|
312
|
+
---
|
|
313
|
+
|
|
314
|
+
## Troubleshooting
|
|
315
|
+
|
|
316
|
+
| Problème | Solution |
|
|
317
|
+
|---------|---------|
|
|
318
|
+
| FFmpeg non trouvé | `winget install FFmpeg` (Win), `brew install ffmpeg` (Mac) |
|
|
319
|
+
| Pas de libwebp | Reinstaller FFmpeg ou installer Pillow |
|
|
320
|
+
| Frames trop lourdes (>10MB) | `--quality 60` ou `--frames 90` |
|
|
321
|
+
| Animation saccadée | Réduire frames, vérifier DPR cap à 2, réduire particules |
|
|
322
|
+
| Flash blanc entre frames | Vérifier extraction, fallback nearest-frame |
|
|
323
|
+
| Canvas blanc sur mobile | Vérifier existence des frames mobile, chemin FRAME_DIR |
|
|
324
|
+
| Barre de chargement bloquée | Frame en 404, vérifier console, vérifier chemins |
|
|
325
|
+
| CORS en local | Servir avec `python3 -m http.server 8080` |
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
name: animated-website
|
|
2
|
+
version: 1.0.0
|
|
3
|
+
title: "Animated Website"
|
|
4
|
+
description: "Convertit des vidéos MP4 en sites web animés de luxe avec scroll frame-by-frame"
|
|
5
|
+
author: Laurent ROCHETTA AI
|
|
6
|
+
icon: "🎬"
|
|
7
|
+
tags: [animation, scroll, video, luxury, canvas, webp]
|
|
8
|
+
triggers:
|
|
9
|
+
- "animated website"
|
|
10
|
+
- "scroll animation"
|
|
11
|
+
- "video to website"
|
|
12
|
+
- "Apple-style page"
|
|
13
|
+
- "scroll-driven site"
|
|
14
|
+
- "frame animation"
|
|
15
|
+
- "site animé"
|
|
16
|
+
requires:
|
|
17
|
+
tools:
|
|
18
|
+
- name: ffmpeg
|
|
19
|
+
install:
|
|
20
|
+
windows: "winget install FFmpeg"
|
|
21
|
+
mac: "brew install ffmpeg"
|
|
22
|
+
linux: "sudo apt install ffmpeg"
|
|
23
|
+
- name: python3
|
|
24
|
+
install:
|
|
25
|
+
windows: "winget install Python.Python.3"
|
|
26
|
+
mac: "brew install python3"
|
|
27
|
+
linux: "sudo apt install python3"
|
|
28
|
+
scripts:
|
|
29
|
+
- "scripts/extract_frames.py"
|
|
30
|
+
commands: []
|
|
31
|
+
workflow:
|
|
32
|
+
- step: 1
|
|
33
|
+
name: "Analyze Video"
|
|
34
|
+
tool: "ffprobe"
|
|
35
|
+
- step: 2
|
|
36
|
+
name: "Extract Frames"
|
|
37
|
+
tool: "extract_frames.py"
|
|
38
|
+
- step: 3
|
|
39
|
+
name: "Prepare Content"
|
|
40
|
+
tool: "agent"
|
|
41
|
+
- step: 4
|
|
42
|
+
name: "Generate HTML"
|
|
43
|
+
tool: "agent"
|
|
44
|
+
- step: 5
|
|
45
|
+
name: "Preview"
|
|
46
|
+
tool: "python http.server"
|
|
47
|
+
platforms:
|
|
48
|
+
bmad:
|
|
49
|
+
target: "_bmad/core/agents/"
|
|
50
|
+
file: "animated-website-agent.md"
|
|
51
|
+
claude:
|
|
52
|
+
target: ".claude/skills/"
|
|
53
|
+
skillName: "animated-website"
|
|
54
|
+
includeScripts: true
|
|
55
|
+
gemini:
|
|
56
|
+
target: ".agent/workflows/"
|
|
57
|
+
file: "animated-website.md"
|
|
58
|
+
opencode:
|
|
59
|
+
target: ".opencode/agents/"
|
|
60
|
+
file: "animated-website.md"
|
|
61
|
+
codex:
|
|
62
|
+
target: ".codex/agents/"
|
|
63
|
+
file: "animated-website.md"
|