Worldbuilder: full-stack app built with Python/FastAPI backend, React/TypeScript frontend, and Neo4j graph database. Containerized using Docker for easy deployment and development. Backend uses uv for Python package management and includes a CORS configuration for frontend-backend communication. The frontend is built with Vite.
-
Set up environment variables:
cp backend/.env-template backend/.env
-
Start all services:
docker-compose up -d
-
Access the applications:
- Frontend: http://localhost:3000
- Backend API: http://localhost:8000
- Neo4j Browser: http://localhost:7475
-
Default Neo4j credentials:
- Username:
neo4j - Password:
WorldBuilder2025!
- Username:
-
Stop all services:
docker-compose down
-
Stop all services and delete data volumes:
docker-compose down -v
Supports hot-reloading for both frontend and backend during development. Any changes to the source code will automatically reflect in the running containers.