This section provides comprehensive technical documentation for developers contributing to or maintaining the Hub Digital platform.
Overview
Hub Digital is built as a monorepo powered by Turborepo and pnpm workspaces. The main application is a Nuxt 3 (Vue 3 + Nitro) SSR web application that connects to a Directus headless CMS backend.
Sections
- Architecture — Monorepo structure, module system, and data flow
- Development Setup — Prerequisites, installation, and local development workflow
- Deployment — Docker builds, CI/CD pipeline, and production configuration
- API Reference — Directus integration, server proxy, and API patterns
- Backend Architecture — Directus CMS backend, PostgreSQL database, and vector storage
- AI Assistant (Toti) — Conversational agent, vector search, and RAG pipelines
- Contributing — Code style, conventions, and pull request guidelines
Key Technologies
| Layer | Technology | Purpose |
|---|---|---|
| Framework | Nuxt 3 | SSR, routing, server-side rendering |
| UI Library | Vue 3 + Composition API | Component development |
| Component Kit | shadcn-vue | Accessible, customizable UI components |
| Styling | Tailwind CSS | Utility-first CSS |
| State | Pinia | Client-side state management |
| Backend | Directus SDK | API communication |
| Validation | VeeValidate + Zod | Form validation |
| Content | Nuxt Content | Markdown-based static content |
| Animations | Motion + GSAP | UI animations |
| Build | Turborepo + Vite | Monorepo orchestration & bundling |