feat: migrate documentation from MkDocs to Docusaurus

- Replace MkDocs with Docusaurus 3.x for modern React-based docs
- Add inline chart editor with iframe integration on click
- Add CSS hover overlay for chart images ("Open in Editor")
- Migrate content generation scripts (error codes, fonts, gallery)
- Update CI/CD workflow for Docusaurus build
- Add local search with @easyops-cn/docusaurus-search-local
- Add mermaid diagram support
- Clean up legacy MkDocs files and assets
- Update .gitignore for generated files

Author: FGRibreau

.env.dist

@@ -12,23 +12,28 @@ jobs:
   build-and-deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
-      - name: Tests
-        run: make test
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "18"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
 
       - name: Build website
-        run: make build
+        run: npm run build
         env:
           ACCOUNT_ID: ${{ secrets.ACCOUNT_ID }}
           SECRET_KEY: ${{ secrets.SECRET_KEY }}
-          GOOGLE_ANALYTICS_TOKEN: ${{ secrets.GOOGLE_ANALYTICS_TOKEN }}
 
-      - name: Deploy to Netlify 🚀
+      - name: Deploy to Netlify
         if: github.ref == 'refs/heads/master'
-        uses: nwtgck/actions-netlify@v1.2
+        uses: nwtgck/actions-netlify@v3
         with:
-          publish-dir: "./site"
+          publish-dir: "./build"
           production-branch: master
           github-token: ${{ secrets.GITHUB_TOKEN }}
           deploy-message: "Deploy from GitHub Actions"
@@ -39,4 +44,4 @@ jobs:
         env:
           NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
           NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}
-        timeout-minutes: 1
+        timeout-minutes: 5

.github/workflows/build.yml

@@ -1,10 +1,36 @@
-docs/logo/*.md
-site
-hmac_.exe
-Program.class
-java.iml
-node_modules
-gallery.json
+# Dependencies
+node_modules/
+
+# Build output
+build/
+.docusaurus/
+
+# Generated documentation (built from external APIs)
+docs/GENERATED-*.md
+
+# Cache
+.cache/
+
+# Misc
+.DS_Store
+*.log
+npm-debug.log*
+yarn-error.log*
+
+# Environment
+.env
+.env.local
 .envrc
-.envrc.dist
-.netlify
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*.sublime-*
+
+# Netlify
+.netlify/
+
+# OS
+Thumbs.db

.gitignore

@@ -0,0 +1,66 @@
+# Image-Charts Documentation - Project Instructions
+
+## Prerequisites
+
+**CRITICAL**: Before any build operation, you MUST source the `.envrc` file:
+
+```bash
+source .envrc
+```
+
+The `.envrc` file contains required environment variables:
+- `ACCOUNT_ID` - Image-Charts account identifier (used for signing gallery URLs)
+- `SECRET_KEY` - HMAC secret key for URL signing
+- `GOOGLE_ANALYTICS_TOKEN` - Analytics tracking
+- Python/pyenv configuration
+
+Without these variables, the `generate:gallery` script will fail.
+
+## Build Commands
+
+```bash
+# Full build (generates docs + builds site)
+source .envrc && npm run build
+
+# Development server
+source .envrc && npm run start
+
+# Generate only (without full build)
+source .envrc && npm run generate
+
+# Serve production build locally
+npm run serve
+```
+
+## Generation Scripts
+
+The build process runs three generation scripts that fetch data from the Image-Charts API:
+
+| Script | Source | Output | Requires Env |
+|--------|--------|--------|--------------|
+| `generate:error-codes` | `https://image-charts.com/errors.json` | `docs/GENERATED-error-codes.md` | No |
+| `generate:google-fonts` | `https://image-charts.com/swagger.json` | `docs/GENERATED-google-fonts.md` | No |
+| `generate:gallery` | `https://image-charts.com/gallery.json` | `docs/GENERATED-gallery.md` | **Yes** (ACCOUNT_ID, SECRET_KEY) |
+
+The gallery script signs chart URLs using HMAC-SHA256 with the `SECRET_KEY`.
+
+## Tech Stack
+
+- Docusaurus 3.x
+- React 19
+- Node.js 18+
+
+## Deployment
+
+Automated via Netlify on push to master branch.
+
+## File Structure
+
+```
+scripts/
+  generate-error-codes.js   # Fetches error codes from API
+  generate-google-fonts.js  # Fetches font list from Swagger
+  generate-gallery.js       # Generates signed gallery URLs
+docs/
+  GENERATED-*.md            # Auto-generated files (do not edit manually)
+```

CLAUDE.md

@@ -1,40 +1,48 @@
-Image-Charts documentation
---------------------------
+# Image-Charts Documentation
 
 Read the documentation [online](https://documentation.image-charts.com/).
 
+## Development
 
-### Start local dev environment
+### Requirements
 
-Requirements:
-- docker
+- Node.js 18+
 
-```
-make serve
-```
+### Install dependencies
 
-### update
-
-Update:
+```bash
+npm install
+```
 
-- image-charts logo versions
+### Start local dev server
 
-```
-make update
+```bash
+npm run start
 ```
 
-### tests
+This will start a local development server at `http://localhost:3000`.
 
-We want that much of our code examples are tested through unit-tests.
+### Build
 
+```bash
+npm run build
 ```
-make test
+
+### Serve production build locally
+
+```bash
+npm run serve
 ```
 
-### deployment
+## Deployment
+
+Deployment is done through Netlify when the master branch is updated.
 
-Deployment is done through Github Actions to Netlify ([admin](https://app.netlify.com/sites/image-charts-documentation/overview)), when master branch is updated.
+- [Netlify Admin](https://app.netlify.com/sites/image-charts-documentation/overview)
 
-### Credits
+## Tech Stack
 
-Image-charts documentation is built upon [mkdocs](https://www.mkdocs.org) and [mkdocs-material](https://github.com/squidfunk/mkdocs-material/).
+- [Docusaurus 3.x](https://docusaurus.io/)
+- [React 19](https://react.dev/)
+- [@easyops-cn/docusaurus-search-local](https://github.com/easyops-cn/docusaurus-search-local) for search
+- [@docusaurus/theme-mermaid](https://docusaurus.io/docs/markdown-features/diagrams) for diagrams

Dockerfile

@@ -32,3 +32,10 @@
     }
   }```
   
+- `IC_EMAIL_NOT_SENT`: Could not send email
+- `IC_SEND_EMAIL_MISSING`: email attribute missing, could not sent email
+- `IC_CONTACT_NOT_UPDATED`: Could not update contact
+- `IC_METADATA_EMAIL_MISSING`: email attribute missing, could not create or update metadata
+- `IC_UPDATE_METADATA_FAILED`: Could not create or update Metadata
+- `IC_CUSTOMER_SEARCH_FAILED`: Customer search failed
+- `IC_DATA_LOADING_FAILED`: Data loading failed