Migratis Base Environment

Minimal full-stack framework for deploying applications generated by migratis.ai.

Stack

• Backend — Django 5 + Django Ninja (REST API) · SQLite (default) or PostgreSQL
• Frontend — React 19 + react-hook-form + i18next
• Docker — all environments

Ports: backend 8004 · frontend 3002

---

Quick Start

1. Generate your application

Go to migratis.ai, describe your application, tweak the sandbox until you are happy, then click Generate.

2. Start the base environment

# Backend
cd backend
bash build-docker-local.sh          # builds image, runs migrations, starts on :8004

# Frontend (separate terminal)
cd frontend
docker compose up -d                # starts on :3002

No database configuration needed — SQLite is used by default.

3. Install your generated application

Open http://127.0.0.1:3002/installer, connect with your migratis.ai credentials, select your application and click Install.

The installer will:

• Download and extract the backend Django module
• Activate required framework modules (auth, i18n, etc.) in settings.py
• Register API routers in api/views.py
• Run migrate and seed translations automatically

4. Apply the frontend

Download the frontend ZIP from the installer result screen, extract it into frontend/src/, then follow the included INSTALL.md to add the new routes to App.js.

5. Restart and create a superuser

docker restart backend-base-api-1

docker exec -it backend-base-api-1 bash
python /backend/manage.py createsuperuser

---

Environment variables

Copy backend/migratis/.env.example and fill in your values. Key variables:

Variable	Default	Description
USE_SQLITE	True	Use SQLite instead of PostgreSQL
MIGRATIS_BACKEND_URL	http://host.docker.internal:8000	URL of the migratis generator (from inside Docker)
SECRET_KEY	—	Django secret key
ALLOWED_HOSTS	127.0.0.1,localhost	Allowed hostnames

---

After installation — switching to PostgreSQL

Set USE_SQLITE=False in .env, fill in DB_* variables, uncomment the db service in docker-compose.yml, then rebuild:

cd backend && bash build-docker-local.sh