Standard React FastAPI Environment

full-stack development environment using:

• Frontend: Expo (React Native + TypeScript)
  • Runs on Web, Android, and iOS with a single codebase
• Backend: FastAPI (Python)
• Database: PostgreSQL
• Container: Docker Compose for consistent development setup

---

Features

• Cross-platform frontend with Expo
  • Runs as a web app or on Android/iOS devices via Expo Go or standalone builds
• CRUD operations : Create, Read, Update, Delete records
• Auth operations : Signup, Signin, Signout
• FastAPI backend with automatic docs
  • REST API with Swagger UI (/docs)

---

🚀 Getting Started

1. Prerequisites

• Docker Compose
• Expo Go (for Android/iOS testing)

2. Build and start all services:

# set environment variables:
export REACT_NATIVE_PACKAGER_HOSTNAME=${YOUR_HOST}

# Build the image
docker compose build

# Run the container
docker compose up

---

3. Test:

# Backend pytest
docker compose \
  -f docker-compose.test.yml run \
  --rm \
  --entrypoint /bin/sh backend_test \
  -lc ' pytest -q '

# Backend Lint
docker compose \
  -f docker-compose.test.yml run \
  --rm \
  --entrypoint /bin/sh backend_test \
  -lc 'ruff check /app /tests'

# Frontend Test
docker compose \
  -f docker-compose.test.yml run \
  --rm frontend_test

---

4. Visit the services:

• Backend API: http://localhost:8000/docs

• Frontend UI (WEB): http://localhost:8081

• Frontend UI (mobile): exp://${YOUR_HOST}:8081: access it with the QR provided by Expo.

---

License

• Apache License 2.0