Docs Workflow¶
This project uses MkDocs for static documentation and GitHub Pages for hosting.
Build Locally¶
From repository root:
dart run melos bootstrap
python3 -m pip install -r docs/requirements.txt
bash docs/scripts/build_docs.sh
Output:
docs/.site/
API Docs Auto-Generation¶
API pages are generated with dart doc from the plugin package:
bash docs/scripts/generate_api_docs.sh
Generated files are placed under:
docs/site/api/flutterxel/
Manual GitHub Pages Deployment¶
Deployment is intentionally manual.
Workflow file:
.github/workflows/docs_manual_deploy.yml
Trigger path:
- Open GitHub Actions.
- Select docs-manual-deploy.
- Click Run workflow.
No push/PR trigger is configured for this workflow.