Developer
b6f89f9df0
- Resolve 57 merge conflicts from codebase restructure - Port dev feature code to new directory structure: * Update import paths to use @/ aliases * Add backward-compatible API signatures (createInstance, startInstance, deleteInstance) * Add missing type exports (ProjectWithRepos, InstanceHealth, Branch, BranchesResponse) * Extend Session and GitRepository types for dev features * Extend TerminalComponent props for mobile terminal wrapper * Add missing icon names (bell, drag, undo) Quality gates: tsc pass (0 errors), build pass, 127/131 tests pass (4 pre-existing failures unrelated to merge)
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.