Developer Guide Overview

Welcome to the MTD (Manage The Day) developer documentation. This guide provides comprehensive information for developers working on the MTD platform.

Repository Structure

The MTD project is a multi-project monorepo containing three main components:

mtd-ai (Backend)

• Technology: Python FastAPI
• Purpose: AI-enhanced backend service with agent management
• Features: Google Vertex AI integration, Firebase authentication, RESTful APIs

mtd-web-v2 (Frontend)

• Technology: Next.js 13+ with React 18.3
• Purpose: Modern web application for productivity management
• Features: Real-time collaboration, Redux state management, Material-UI

mtd-docs (Documentation)

• Technology: Nextra (Next.js-based)
• Purpose: User and developer documentation
• Features: MDX support, interactive examples, API reference

Quick Links

• Git Branching Strategy - Learn about our development workflow
• Getting Started - Set up your development environment
• Architecture - Understand the system design
• API Reference - Explore available endpoints
• Contributing - Guidelines for contributors

Development Philosophy

Code Quality First

• Comprehensive type checking with TypeScript
• Automated formatting and linting
• Required code reviews for all changes

Multi-Environment Support

• Development, staging, and production environments
• Feature flags for progressive rollouts
• Isolated Firebase projects per environment

Security by Design

• JWT-based authentication
• Organization-scoped data access
• Regular security audits

Getting Help

• GitHub Issues: Report bugs or request features
• Code Comments: Use inline documentation
• Team Chat: Reach out in development channels
• Documentation: Always check existing docs first

Navigation

Use the sidebar to explore specific topics in depth. Each section contains detailed information, code examples, and best practices for that area of development.