Delivery App - Production-Ready Starter

Mobile-first delivery application with Expo frontend and FastAPI backend.

Architecture

• Mobile: Expo React Native (iOS/Android)
• Backend: FastAPI with PostgreSQL
• Deployment: Docker (backend), EAS Build (mobile)

Quick Start

Backend Development

make dev-backend
# API at http://localhost:8000

Mobile Development

cd services/mobile
npm install
npm start
# Scan QR code with Expo Go app

Project Structure

delivery-app/
├── services/
│   ├── backend/          # FastAPI application
│   │   ├── src/
│   │   │   ├── main.py   # API endpoints
│   │   │   ├── models/   # Domain models
│   │   │   └── schemas/  # API schemas
│   │   └── Dockerfile
│   └── mobile/           # Expo application
│       ├── src/
│       │   ├── screens/  # App screens
│       │   ├── api/      # API client
│       │   └── types/    # TypeScript types
│       ├── app.config.js
│       └── eas.json
├── infrastructure/       # Docker Compose
└── scripts/             # Build & deploy scripts

Deployment

Backend

make deploy-backend  # Docker deployment

Mobile

./scripts/build-mobile.sh all production

Features

• ✅ Order creation and management
• ✅ Real-time order status tracking
• ✅ Driver location updates
• ✅ Health checks and monitoring
• ✅ Semantic versioning via Git
• ✅ CI/CD workflows
• ✅ Type-safe API contracts

Documentation

• Backend API: http://localhost:8000/docs
• Mobile setup: services/mobile/README.md

---

Built with: FastAPI • Expo • Docker • TypeScript • PostgreSQL