Standard React FastAPI Environment

Mobile UI

Expo mobile screenshot

Web UI

"web_ui"

Um full-stack starter container pronto para executar, criado para conectar um app Expo React Native a um backend FastAPI.

Este template inclui um frontend Expo React Native, um backend FastAPI, PostgreSQL, JWT authentication, CRUD APIs, Docker Compose, backend tests, frontend tests e GitHub Actions CI.

Use este repository quando quiser criar um mobile app ou web app com Expo e conectá-lo a um backend FastAPI.

full-stack development environment usando:

Frontend: Expo (React Native + TypeScript)
- Executa em Web, Android e iOS com uma única codebase
Backend: FastAPI (Python)
Database: PostgreSQL
Container: Docker Compose para um development setup consistente

Features

Cross-platform frontend com Expo
- Executa como web app ou em Android/iOS devices via Expo Go ou standalone builds
CRUD operations : criar, ler, atualizar e excluir records
Auth operations : Signup, Signin, Signout
FastAPI backend com automatic docs
- Versioned REST API em /api/v1 com Swagger UI (/docs)

🚀 Getting Started

1. Prerequisites

Docker Compose
Expo Go (para Android/iOS testing)

2. Build e start de todos os 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. Acesse os services:

Backend API: http://localhost:8000/docs
Frontend UI (WEB): http://localhost:8081
Frontend UI (mobile): exp://${YOUR_HOST}:8081: acesse com o QR fornecido pelo Expo.

License

Apache License 2.0