Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

geek14place88

A static game-night tracker built for GitHub Pages.

It helps your group:

  • track games you want to play
  • log games you already played
  • mark favorites
  • spin a random wheel for session picks
  • filter by vibe tags like chill, survival, co-op, horror
  • switch between night themes while you play

What It Does

geek14place88 is a browser-only app.

That means:

  • it works on GitHub Pages
  • it does not need a backend
  • your data is saved in the current browser with localStorage
  • different devices do not automatically share the same live data

Current Features

Core tracking

  • Add, edit, and delete games
  • Mark a game as Want to play or Played
  • Save accounts we have it on
  • Add comma-separated tags
  • Save notes and ratings
  • Mark games as favorites

Session features

  • Spin wheel with 3 modes:
    • Want to play
    • Played
    • All games
  • Quick pick button
  • Result card for the current chosen game
  • Confetti / celebration effects for fun moments

Browsing and organization

  • Search by title, notes, tags, and accounts
  • Filter by status
  • Filter by tag
  • Show only favorites
  • Sort by:
    • recently updated
    • title
    • tags
    • rating

Visual extras

  • Multiple night themes:
    • Arcade Glow
    • Midnight Raid
    • Campfire Chaos
    • Aurora Chill
  • Separate sections for:
    • wheel / session tools
    • editor
    • favorites lounge
    • library filters
    • game lists

Backup / portability

  • Export your tracker to JSON
  • Import a JSON backup
  • Optional seed-data reset support

Data Behavior

This project currently uses browser storage as the main source of truth.

  • Each browser keeps its own local saved list
  • Opening the site on another device starts with a separate copy
  • If browser storage is cleared, the local list is removed
  • Theme choice is also stored locally

About seed-games.json

There is a file at data/seed-games.json.

Right now it is empty, so first-time visitors start with a blank tracker.

The Reset to seed button only becomes useful if you put starter games into that file.

Simple Shared Workflow Without a Backend

If your group wants one manually shared version, use this workflow:

  1. Use the site on one main device during Geeknight
  2. Click Export JSON at the end
  3. Replace the contents of data/seed-games.json with the exported data
  4. Commit and push to GitHub
  5. GitHub Pages republishes the updated version

This keeps the project fully static while still giving your group a shared published list.

Run Locally

Because the app loads JSON files, do not open index.html directly.

Run a local server:

python3 -m http.server 8000

Then open:

http://localhost:8000

Deploy To GitHub Pages

  1. Push this project to a GitHub repository
  2. Open the repository on GitHub
  3. Go to Settings -> Pages
  4. Under Build and deployment, choose Deploy from a branch
  5. Select your main branch and the / (root) folder
  6. Save

After GitHub Pages finishes publishing, the site will be live.

Project Structure

.
├── index.html
├── styles.css
├── app.js
├── README.md
└── data/
    └── seed-games.json
  • index.html: page structure and sections
  • styles.css: themes, layout, wheel styling, visual effects
  • app.js: storage, filters, favorites, wheel logic, confetti, import/export
  • data/seed-games.json: optional starter/shared data

Notes

  • The app still supports loading older browser data saved under previous storage keys
  • Since the seed file is empty right now, new visitors start with an empty tracker
  • For truly shared live updates between all friends, this UI would need Supabase, Firebase, or another backend

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages