CodeRED-Astra 🚀

A hackathon-ready project with React frontend and Rust backend engine.

Quick Start

# 1. Setup environment
cp .env.example .env
# Edit .env with your credentials

# 2. Start everything with Docker
docker-compose up --build

# 3. Access your app
# Frontend: http://localhost
# API: http://localhost:8000
# Database Admin: http://127.0.0.1:8080

Development

Frontend (React + Vite):

cd web-app
npm install
npm run dev  # http://localhost:5173

Backend (Rust):

cd rust-engine  
cargo run    # http://localhost:8000

Architecture

• Frontend: React 18 + Vite + Tailwind CSS
• Backend: Rust + Warp + SQLx
• Database: MySQL 8.0 + phpMyAdmin
• API: RESTful endpoints with CORS enabled
• Docker: Full containerization for easy deployment

Project Structure

├── web-app/           # React frontend
│   ├── src/
│   │   ├── App.jsx    # Main component
│   │   └── main.jsx   # Entry point
│   └── Dockerfile
├── rust-engine/       # Rust backend
│   ├── src/
│   │   └── main.rs    # API server
│   └── Dockerfile
├── docker-compose.yml # Full stack orchestration
└── .env.example      # Environment template

Team Workflow

• Frontend devs: Work in web-app/src/, use /api/* for backend calls
• Backend devs: Work in rust-engine/src/, add endpoints to main.rs
• Database: Access phpMyAdmin at http://127.0.0.1:8080

Features

✅ Hot reload for both frontend and backend
✅ Automatic API proxying from React to Rust
✅ Database connection with graceful fallback
✅ CORS configured for cross-origin requests
✅ Production-ready Docker containers
✅ Health monitoring and status dashboard

Ready for your hackathon! See DEVELOPMENT.md for detailed setup instructions.