README.md

metadata

title: LifeFrontier
emoji: 🔥
colorFrom: pink
colorTo: red
sdk: gradio
sdk_version: 5.49.0
app_file: app.py
pinned: false
license: mit
short_description: Couple game

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

🏠 Life Frontier: Partner's Concerto

A turn-based strategy game for couples built with Gradio.

Quick Start

Local Development

pip install gradio
python app.py

Open: http://localhost:7860

How to Play

Setup

1. Player 1: Click "Create Room", get Room ID
2. Player 2: Enter Room ID, click "Join Room"
3. Game starts automatically when 2 players join
4. Others can join as spectators

Gameplay

• Goal: Achieve highest QoL score after 8 rounds
• Resources: Time (24h/turn), HP, CP, Money, Stress
• Actions: Rest, Execute Tasks, End Turn
• Turn-based: Players alternate taking actions
• Elimination: Stress ≥ 20 = game over

Rest Actions

• Quick Nap (3h): Roll dice, recover 2× HP
• Full Sleep (9h): Recover to HP=8, CP=4, -1 stress
• Deep Rest (12h): Full recovery, -2 stress

Tasks

• Work (W): Earn money
• Domestic (D): Reduce stress
• Health (H): Upgrade stats
• Relationship (R): Bond + reduce stress
• QoL (Q): Convert money to points

Winning

Final QoL = Base QoL + Health Bonus - Stress
Health Bonus = (HP max - 10) × 2 + (CP max - 5) × 3 + Reputation

Features

✅ Turn-based gameplay with SQLite state ✅ Real-time spectator mode ✅ Public rankings system ✅ Persistent game history ✅ Single Docker container ✅ No WebSocket complexity

Game State Management

All state stored in SQLite:

• rooms: Game rooms and status
• players: Player resources and stats
• spectators: Viewers list
• rankings: Leaderboard
• game_history: Completed games

Architecture

app.py (Single File)
├── Database Layer (SQLite)
├── Game Logic (Turn-based)
├── Gradio UI (3 tabs)
└── Session Management

No server, no WebSocket - just simple turn-based updates!

Tips

• Refresh button updates game state
• Rankings show top players by average QoL
• Spectators can watch live but can't play
• Room IDs are permanent until game ends