Developer
3f5159fb8a
- Add docs/development/naming.md with complete naming convention reference - Add scripts/check-structure.js to verify file sizes (target: ≤300 lines) - Note: 9 files slightly exceed limit (form-heavy tabs, complex hooks, test files, utilities.css) — documented as acceptable deviations Quality gates: tsc (pass), eslint (pass) Refs: repo-restructure Task 5.2
Headquarter Documentation
Welcome to the Headquarter documentation. This is your central hub for understanding, using, and contributing to the platform.
Quick Links
- Features - Learn about available features
- API Reference - API endpoint documentation
- Architecture - System design and architecture
- Deployment - Setup and deployment guides
- Development - Development and contributing guides
Getting Started
New to Headquarter? Start here:
- Quick Start - Get up and running
- Features - Discover what you can do
- Architecture - Understand the system
Documentation Structure
Features
User guides for each feature:
- Projects - Project management
- Repositories - Git repository management
- Workspace - Repository workspace
- Git History - History visualization
- Web Terminal - Interactive terminal for tool instances
- Authentication - Login and user management
- Settings - User preferences
- Tool Types - Development tool management
- SSH Keys - SSH key management
API Reference
Complete API documentation:
- Auth - Authentication endpoints
- Projects - Project endpoints
- Repositories - Repository endpoints
- Users - User endpoints
- Tool Types - Tool type endpoints
- SSH Keys - SSH key endpoints
Architecture
System architecture documentation:
- Backend - Backend architecture
- Frontend - Frontend architecture
- Database - Database schema
- Deployment - Deployment architecture
Deployment
Guides for deploying Headquarter:
- Docker - Docker setup
- Traefik - Traefik configuration
- Authentik - Authentik setup
- Environment - Environment variables
Development
Guides for developers:
- Setup - Development environment
- Testing - Testing strategy
- Contributing - How to contribute
- Quality Gates - Code quality
Contributing to Documentation
When adding new features, please document them following our templates:
See the Contributing Guide for more details.