🌐 ForgeMaze Web

Main web application for ForgeMaze platform - create, share, and discover amazing procedurally generated mazes.

✨ Features

• 🎨 Visual Maze Editor - Intuitive 2D editor with real-time preview
• 🔍 Maze Gallery - Browse thousands of community-created mazes
• 🎲 Procedural Generation - Multiple algorithms (Prim's, Recursive Backtracker, etc.)
• 👤 User Profiles - Portfolio, achievements, and statistics
• 👥 Community - Comments, ratings, collections, and following
• 📤 Export - JSON, XML, Unity, Unreal, and more formats
• 🌍 Internationalization - Multi-language support

🚀 Quick Start

Prerequisites

• Node.js 18+ and npm/pnpm/yarn

Installation

# Clone the repository
git clone https://gitlab.com/forgemaze/fm-web.git
cd fm-web

# Install dependencies
npm install

# Copy environment variables
cp .env.example .env.local

# Start development server
npm run dev

Visit http://localhost:5173

Build for Production

npm run build
npm run preview

📁 Project Structure

forgemaze-web/
├── src/
│   ├── components/      # Reusable Vue components
│   ├── views/           # Page components
│   ├── stores/          # Pinia state management
│   ├── router/          # Vue Router configuration
│   ├── services/        # API services
│   ├── composables/     # Vue composables
│   └── assets/          # Static assets
├── public/              # Public static files
└── tests/               # Unit and E2E tests

🛠️ Tech Stack

• Framework: Vue.js 3 (Composition API)
• Language: TypeScript
• Routing: Vue Router 4
• State: Pinia
• Styling: Tailwind CSS
• HTTP: Axios
• Build: Vite
• Testing: Vitest + Cypress

🌍 Environment Variables

VITE_API_BASE_URL=http://localhost:8080/api/v1
VITE_PLAYER_URL=http://localhost:5174

📚 Scripts

npm run dev          # Start dev server
npm run build        # Build for production
npm run preview      # Preview production build
npm run test         # Run unit tests
npm run test:e2e     # Run E2E tests
npm run lint         # Lint code
npm run format       # Format code with Prettier

🤝 Contributing

See CONTRIBUTING.md for contribution guidelines.

🔗 Links

• Documentation
• API Reference
• Community Forum