Full-stack application with Django backend and React frontend.

├── backend/              # Django REST API
│   ├── config/          # Django project settings
│   ├── apps/            # Django apps
│   │   └── api/        # API endpoints
│   ├── tests/          # Backend tests
│   └── manage.py       # Django management script
├── frontend/            # React application
│   ├── src/
│   │   ├── components/ # Reusable components
│   │   ├── pages/      # Page components
│   │   ├── services/   # API client
│   │   ├── hooks/      # Custom React hooks
│   │   ├── utils/      # Utility functions
│   │   └── types/      # TypeScript types
│   └── public/         # Static assets
└── docker-compose.yml  # Docker orchestration

1. Clone and setup

   git clone <your-repo-url>
   cd MLH-DigitalOcean-Hackathon

2. Configure environment

   cp backend/.env.example backend/.env
   cp frontend/.env.example frontend/.env

3. Run with Docker

   docker-compose up

   • Backend: http://localhost:8000
   • Frontend: http://localhost:3000
   • API health check: http://localhost:8000/api/health/

1. Create virtual environment

   cd backend
   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

2. Install dependencies

   pip install -r requirements.txt

3. Configure environment

   cp .env.example .env
   # Edit .env with your settings

4. Run migrations

   python manage.py migrate

5. Create superuser (optional)

   python manage.py createsuperuser

6. Run development server

   python manage.py runserver

   Backend will be available at http://localhost:8000

1. Install dependencies

   cd frontend
   npm install

2. Configure environment

   cp .env.example .env

3. Run development server

   npm run dev

   Frontend will be available at http://localhost:3000

• Run tests: python manage.py test
• Create new app: python manage.py startapp app_name
• Make migrations: python manage.py makemigrations
• Apply migrations: python manage.py migrate
• Admin panel: http://localhost:8000/admin/

• Run tests: npm test (when configured)
• Build for production: npm run build
• Preview production build: npm run preview

• Health check endpoint: GET /api/health/

• Django 5.0
• Django REST Framework
• SQLite (development) / PostgreSQL (production)
• CORS headers for cross-origin requests

• React 18
• TypeScript
• Vite
• React Router
• Axios

• Presentation: Slides
• Figma Prototype: Link
• Live Demo: YouTube

See LICENSE file for details.