Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

12 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿงฌ FateLife: The Definitive Text-Based Life Simulator

FateLife Life Journey Banner

Vite Badge React 18 Badge Zustand Badge Tailwind Badge TypeScript Badge


๐ŸŒŸ The Vision

FateLife is an immersive, completely client-side, text-based life simulation engine. Seamlessly blending the rich, sandbox-style decision matrix of classic simulation with elegant, high-contrast modern web interfaces, FateLife invites players to forge their own paths through billions of life-path variations.

From your very first breath to your golden years, every tap of the Age button advances your personal narrative. Will you become a high-earning brain surgeon, a real-estate mogul, a loving parent, or an infamous mastermind running from the law? Your destiny is entirely in your hands.


๐ŸŽฎ Key Gameplay Dimensions

                   โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                   โ”‚   YOUR CHARACTER INCEPTION  โ”‚
                   โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                  โ–ผ
         โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
         โ–ผ                        โ–ผ                        โ–ผ
 โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•—     โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•—     โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•—
 โ•‘  ACADEMIC PATH   โ•‘     โ•‘  SOCIAL MATRIX   โ•‘     โ•‘  FINANCIAL HUD   โ•‘
 โ• โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ฃ     โ• โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ฃ     โ• โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•ฃ
 โ•‘ โ€ข primary school โ•‘     โ•‘ โ€ข parent bonding โ•‘     โ•‘ โ€ข cash balances  โ•‘
 โ•‘ โ€ข high school    โ•‘     โ•‘ โ€ข dating/partner โ•‘     โ•‘ โ€ข annual salary  โ•‘
 โ•‘ โ€ข university     โ•‘     โ•‘ โ€ข marriage/prenupโ•‘     โ•‘ โ€ข debt & loans   โ•‘
 โ•‘ โ€ข graduate major โ•‘     โ•‘ โ€ข children loops โ•‘     โ•‘ โ€ข assets/upkeep  โ•‘
 โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•     โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•     โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•
         โ”‚                        โ”‚                        โ”‚
         โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                  โ–ผ
                   โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                   โ”‚    LIFE SEED RE-CREATION    โ”‚
                   โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

1. The Core Attribute Wheel

Your avatar's success is governed by a network of six dynamic, interconnected vital statistics:

  • ๐Ÿ˜Š Happiness: Dictates mental wellness, event resiliency, and relationship success.
  • ๐Ÿ’ช Health: Your physical life-force. Sinks under stress or disease; rises with active gym routines and physician interventions.
  • ๐Ÿง  Smarts: Determines academic eligibility, scholarships, high-level career entry, and general puzzle resolution.
  • โœจ Looks: Affects dating market opportunities, public engagement success, and unique interactions.
  • โ˜ฏ๏ธ Karma: Elevated by selfless, supportive decisions; hidden weight affecting random event distributions and survival odds.
  • โšก Stress: Tracks academic, corporate, or financial strain. Leaving stress unmanaged leads directly to severe physical and mental burnout.

2. The Academic & Career Engine

Education and Career Paths

Navigate a fully featured, progressive scholastic hierarchy:

  • Study Tracks: Maintain high grades to secure prestigious parent funding or academic scholarships.
  • Specialization: Major in Biology, Finance, Political Science, or English Literature.
  • Graduate Schools: Master the professions by qualifying for Law School, Medical School, or elite Business Administration (MBA) courses.
  • Dynamic Labor Market: Browse the active job boards. Advance from junior entry-level roles up to executive positions with complex qualification gates (minimum smarts, specific degree, and health standards).

3. High-Fidelity Asset Portfolio

Assets and Luxury Marketplace

Amass and manage real-world wealth:

  • Real Estate Portfolio: Scout housing listings ranging from rustic trailer parks and cozy modern condos to sprawling ranches and haunted, historical mansions.
  • Automotive Dealerships: Invest in commuter vehicles, massive family SUVs, precision sports cars, or eye-watering exotic supercars.
  • Financing & Mortgages: Purchase premium properties on debt structures, managing annual principal payments and interest rates against your net income.
  • Asset Degradation: Every asset undergoes realistic annual wear, value depreciation, and upkeep. Will you maintain them or let them crumble?

4. Dynamic Relationship Matrix

Build real family trees with deep interpersonal memory:

  • Family Bonding: Interact, converse, or ask for money from your parents and siblings.
  • Dating Mechanics: Seek out romantic partners with individual looks, smarts, and generosity attributes.
  • Matrimony: Handle engagement requests, plan the wedding, sign prenuptial agreements, and raise biological or adopted children.
  • Legacy & Inheritance: Relatives can leave substantial estate cash, properties, or valuable jewelry upon their peaceful passing.

5. Underworld Crime & Justice Systems

Underworld Crime and Courtrooms

Walk on the wild sideโ€”if you dare:

  • Illicit Activities: Choose from petty crimes like pickpocketing classmates, shoplifting, and spray-painting walls, up to high-stakes grand theft auto and armed bank robberies.
  • The Courtroom: Getting caught triggers instant legal trials. Hire cheap public defenders or premier defense lawyers to beat charges, or pay enormous fines.
  • Prison Yard Sandbox: Sentenced to prison? Live through minimum, medium, or maximum-security sentences. Attempt high-stakes tactical breakouts, request work detail to earn safety, or interact with fellow inmates.

6. The Animal Kingdom & Pet Markets

Seek comfort and joy through extensive veterinary and pet adoption panels:

  • Shelter Adoptions: Adopt standard, loving mixed breeds seeking a warm, happy home.
  • Elite Breeders: Secure purebred companions with detailed statistics like crazy levels, closeness, and health.
  • Exotic Smugglers: Purchase highly illegal, dangerous exotic species under-the-counterโ€”but beware of local wildlife authority arrests!

๐Ÿ› ๏ธ Technical Design & Craftsmanship

FateLife represents a masterclass in modern, client-side, zero-database state management.

                  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                  โ”‚          VITE DEVELOPMENT HOST         โ”‚
                  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                      โ–ผ
                  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                  โ”‚          ZUSTAND STORE ENGINE          โ”‚
                  โ”‚   (Maintains entire state-tree: HUD,   โ”‚
                  โ”‚   Finances, Assets, Crime, Relations)  โ”‚
                  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                         โ”‚                          โ”‚
                         โ–ผ                          โ–ผ
         โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
         โ”‚       GAME LOOP TICKER       โ”‚  โ”‚      DETERMINISTIC RNG       โ”‚
         โ”‚   โ€ข Annual Age Increments    โ”‚  โ”‚   โ€ข Condition-based Events   โ”‚
         โ”‚   โ€ข Balance-sheet calculationsโ”‚  โ”‚   โ€ข Stats Degradation        โ”‚
         โ”‚   โ€ข Compound Interest drift  โ”‚  โ”‚   โ€ข Random Disease Spikes    โ”‚
         โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ“ฆ Key Architectural Pillars:

  1. Unified State Store (Zustand): Leverages a robust, reactive Zustand state slice architecture (src/gameStore.ts). Every financial transaction, attribute degradation, age advancement, and family interaction resolves through deterministic state-mutating actions with flawless atomic performance.
  2. Modular React Architecture: Avoids monolith code pitfalls. Distinct UI tabsโ€”including the CareersPanel, AssetsPanel, PrisonYardPanel, RelationshipsPanel, and PetShoppingMarketplaceโ€”are compartmentalized into clean, decoupled files, preventing generation truncation and maximizing codebase agility.
  3. Tailwind CSS Polish: Features a high-contrast dark visual theme inspired by premium slate dashboards. Elegant animations from motion/react provide satisfying, responsive transitions for game events, trial modals, and annual timeline additions.
  4. Deterministic Event Registry: Hundreds of rule-bound narrative occurrences (src/data/events/) trigger procedurally based on your character's current age, finances, relationship status, criminal standing, and geographic parameters.

๐Ÿš€ Quick Start Guide

1. Prerequisites

Ensure you have Node.js 18+ installed on your workstation.

2. Installation

Clone the repository and install all required framework packages:

npm install

3. Spin up Dev Server

Launch the superfast local Vite dev server on the default container port:

npm run dev

Open http://localhost:3000 inside your web browser to start playing instantly.

4. Build for Production

Bundle the optimized client-side single page application (SPA):

npm run build

Static static files are rendered securely to the /dist directory.


๐Ÿ“ License

Licensed under the Apache License, Version 2.0 (the "License"). You may obtain a copy of the License at: http://www.apache.org/licenses/LICENSE-2.0

FateLife โ€” Write your legacy, one decision at a time.

About

Life Simulator

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages