Getting started
Welcome to the Hoggar documentation portal — the shared knowledge base for developers and AI agents working on Hoggar.
Hoggar is an adventure and off-road travel platform for adventure motorcycle riders, off-road riders, overlanders, 4x4 travelers, campervan/motorhome travelers, and outdoor explorers.
Current phase
Hoggar is in Sprint 0 — Foundation. Most of this portal describes the foundations and the target architecture; product features are not built yet.
Source of truth
Hoggar follows a Docs-as-Code approach:
- Markdown stored in Git is the canonical source.
- This portal (Docusaurus) is only the presentation layer.
- English is the canonical language. French and Arabic translations are planned later.
PROJECT_CONTEXT.md, at the root of thehoggar-docsrepository, is the central source of truth for the global project context and current state.
How this documentation is organized
| Section | What you will find |
|---|---|
| Product | What Hoggar is and the long-term product direction |
| Architecture | Target architecture, technology choices and ADRs |
| Development | Git workflow, specification flow, engineering principles |
| Infrastructure | VPS, Ansible, Docker, Coolify and GitLab |
| Deployment | Current deployment model and target CI/CD pipeline |
| Security | Security layers and rules |
| AI Agents | How AI coding agents work on Hoggar |
| API | The future Hoggar REST API |
Status labels
Pages use the following labels to distinguish reality from intent:
- Operational — in place and working today.
- Planned — selected, not yet implemented.
- Deferred — intentionally postponed until a concrete requirement exists.