Welcome to ft_transcendence! This is a full-stack web application featuring a real-time 3D Pong game with multiplayer capabilities, user management, chat functionality, tournaments, and much more.
- 🎮 3D Pong Game with Babylon.js
- 🌐 Real-time Multiplayer gaming
- 🏆 Tournament System with matchmaking
- 💬 Live Chat and messaging
- 👥 User Management with profiles and friends
- 🔐 Security with 2FA and OAuth
- 📱 Compatibility with all browsers
- 🚀 Containerized deployment with Docker
 🔐 Authentication Secure login (Password or OAuth) |
 🎮 Game Map selector & game modes |
 🏓 Live Gameplay 3D Pong with live chat |
 📊 User Profile Stats & match history |
 ⚙️ Settings & Privacy Avatar upload, 2FA, GDPR features |
|
| Category | Technology |
|---|---|
| Frontend | TypeScript, Vite, Tailwind CSS, Babylon.js, SPA |
| Backend | Node.js, Fastify, SQLite |
| Security | JWT, OAuth 2.0, 2FA (TOTP), bcrypt, HTTPS, WSS |
| Real-time | WebSockets (ws library) |
| Infrastructure | Docker, Docker Compose, Caddy |
- Docker
- Docker Compose
- Make
-
Clone the repository
git clone <repository-url> cd ft_transcendence
-
Configure environment variables
cp .env.prod.example .env.prod # Edit .env.prod with your secrets (JWT_SECRET, COOKIE_SECRET, Google OAuth credentials) -
Generate secrets (if needed)
# JWT Secret (64 characters) openssl rand -hex 32 # Cookie Secret (32 characters) openssl rand -hex 16
# Start the application
make prod-up
# View logs
make prod-logs
# Stop the application
make prod-down
# Alternatively: restart the application
make prod-re# Start development environment
make dev
# Clean up development containers
make clean# Complete Docker cleanup
make ff_clean_docker
# Update environment variables
make update-envft_transcendence/
├── core/
│ ├── frontend/ # Vite + TypeScript frontend
│ ├── backend/ # Fastify + Node.js backend
│ └── game_shared/ # Shared game logic
├── docker/ # Docker configurations
└── docker-compose.yml # Container orchestration
- Production:
https://localhost:443orhttps://<your-hostname>:1443 - Development:
http://localhost:5173(Frontend) +http://localhost:3000(Backend)
This project fulfilled all mandatory requirements and includes multiple bonus modules from the subject.
Final Score: 125/100 🎉
- ✅ Frontend Framework: TypeScript
- ✅ Single Page Application: Complete SPA architecture
- ✅ Browser Compatibility: Firefox, Chrome, Brave
- ✅ Containerization: Docker deployment with single command
- ✅ Live Multiplayer Pong: Real-time gameplay
- ✅ Local & Remote Play: Same keyboard or different players
- ✅ Tournament System: Multi-player tournaments with matchmaking
- ✅ Server-Side Game Logic: Anti-cheat protection
- ✅ 3D Graphics: Immersive Babylon.js rendering with camera controls
- ✅ Game Customization: Adjustable game parameters
- ✅ Secure Authentication: Hashed passwords with strong algorithms
- ✅ OAuth Integration: Google Sign-In support
- ✅ User Profiles: Custom avatars, usernames, display names
- ✅ Statistics Tracking: Win/loss records and match history
- ✅ Two-Factor Authentication: Enhanced security with 2FA
- ✅ GDPR Compliance: Data export, anonymization, and deletion
- ✅ Real-time Chat: Direct messaging between users
- ✅ Friends System: Add friends and view online status
- ✅ User Blocking: Block unwanted interactions
- ✅ Game Invitations: Invite friends to matches
- ✅ HTTPS/WSS: End-to-end encryption
- ✅ Input Validation: Frontend and backend validation
- ✅ Protected Routes: Secure access control
- ✅ CSRF Protection: Cross-site request forgery prevention
| Name | Role | Profile |
|---|---|---|
| Fabian Rapp | Game | |
| Iliès Ziane | Backend | |
| Maksim Volkmann | Frontend | |
| Daniel Ilin | Frontend | LinkedIn | Website |