Skip to content

rrtrytcg/French-Football-Manager

Repository files navigation

Le Manager Français — Classroom Edition

Teach French vocabulary through live football management. Free hosting, zero setup.

Version License Node

Real-time multiplayer game for French teachers. Students answer questions to earn euros, upgrade teams, and compete in an automated league.


For Teachers: Use It Now

Option 1 — Use the public demo: https://french-football-manager.onrender.com

  1. Click "Créer une salle"
  2. Paste Quizlet or click "Use Sample A1"
  3. Share QR code — students join

Option 2 — Deploy your own (free):

Deploy to Render

  1. Click button → connect GitHub → Create
  2. Wait 3 minutes for build
  3. Get your *.onrender.com URL

No credit card. No CLI. Free forever.


Teacher Workflow (30 seconds)

  1. Create Room → 4-digit code + QR appears automatically
  2. Import → paste Quizlet export (any format) or use built-in decks
  3. Start → game auto-cycles: 40s questions → 20s match
  4. End → export CSV scores

Import accepts:

bonjour	hello
bonjour - hello
bonjour, hello
bonjour  hello

Features

  • Real-time multiplayer (Socket.io, up to 40 students)
  • 10-second Quizlet import with live preview
  • Sample A1-B2 decks built-in
  • Team customization, upgrades, transfer market
  • Mystery boxes, league table
  • Teacher controls: pause, extend, export
  • PWA — works on Chromebooks/iPads
  • No student accounts, no PII stored

Quick Start (Developers)

git clone https://github.com/rrtrytcg/French-Football-Manager
cd French-Football-Manager
cp .env.example .env
npm run install:all
npm run dev

Client: http://localhost:5173 Server: http://localhost:3001


Deploy to Render

Render auto-detects settings from render.yaml:

  • Build: npm run install:all && npm run build
  • Start: npm run start
  • Plan: Free
  • Health check: /health

Project Structure

/client/src/components/QuizletImporter.jsx
/server/src/
  index.js (with /health)
  quiz.js (parseQuizletText)
/server/data/sample-a1.json
render.yaml
Dockerfile

Environment

PORT=3001
NODE_ENV=production
CORS_ORIGIN=*
ROOM_TTL_MINUTES=120
MAX_PLAYERS_PER_ROOM=40

License

MIT — free for schools

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages