How ayfri/atom-clicker works
Atom Clicker is a SvelteKit incremental game. The player interacts with the game page to click atoms, buy production buildings and upgrades, unlock skills, collect power-ups, and progress through Photon, Radiation, and prestige realms. GameManager owns mutable progression and persistence; specialized components present each domain. Optional simulation benchmarks exercise the same state manager. Authenticated routes provide leaderboard, Quark rewards, cosmetics, statistics, and error reporting through Supabase. Some client composition is inferred from the tree and README because page/component implementations were not sampled.
Main entry points: GameManager.svelte.ts Game Manager · supabase.server.ts Supabase Service · +server.ts Leaderboard API · quarks Quark APIs
Components 26
Game Client
- Game Page
src/routes/+page.svelte - Game Manager
src/lib/helpers/GameManager.svelte.ts - Atom Canvas
src/lib/components/game/Canvas.svelte
Progression Systems
- Buildings
src/lib/components/game/Buildings.svelte - Upgrades
src/lib/components/game/Upgrades.svelte - Skill Tree
src/lib/components/modals/SkillTree.svelte - Prestige Realms
src/lib/components/prestige - Photon Realm
src/lib/components/prestige/PhotonRealm.svelte - Radiation Realm
src/lib/components/radiation - Power Ups
src/lib/components/hud/ActivePowerUps.svelte - Quarks Quests
src/lib/components/modals/Quarks.svelte - Simulation Engine
src/lib/simulation/engine.ts
Persistence Layer
- Save Manager
src/lib/helpers/saves.ts - Offline Progress
src/lib/helpers/offlineProgress.ts - Browser Storage
src/lib/utils/safeLocalStorage.ts
Online Services
- Leaderboard UI
src/lib/components/modals/Leaderboard.svelte - Leaderboard API
src/routes/api/leaderboard/+server.ts - Quark APIs
src/routes/api/quarks - Auth Status API
src/routes/api/auth/status/+server.ts - Stats API
src/routes/api/stats/+server.ts - Error API
src/routes/api/errors/+server.ts - Data Verification
src/lib/server/obfuscation.server.ts - Supabase Service
src/lib/server/supabase.server.ts
Other components
- Player
- Supabase
- Auth Provider
Connections 26
- Player → Game Page: plays
- Game Page → Game Manager: updates
- Game Manager → Atom Canvas: renders state
- Game Manager → Buildings: feeds production
- Buildings → Game Manager: buys buildings
- Upgrades → Game Manager: buys upgrades
- Skill Tree → Game Manager: buys skills
- Prestige Realms → Game Manager: resets progress
- Photon Realm → Game Manager: collects photons
- Radiation Realm → Game Manager: controls reactor
- Power Ups → Game Manager: collects boosts
- Quarks Quests → Game Manager: tracks rewards
- Simulation Engine → Game Manager: ticks state
- Game Manager → Save Manager: serializes state
- Game Manager → Offline Progress: applies progress
- Save Manager → Browser Storage: reads writes
- Leaderboard UI → Leaderboard API: loads scores
- Leaderboard API → Data Verification: verifies payload
- Leaderboard API → Supabase Service: reads writes profiles
- Quark APIs → Data Verification: verifies payload
- Quark APIs → Supabase Service: claims entitlements
- Auth Status API → Supabase Service: checks session
- Stats API → Supabase Service: counts profiles
- Error API → Supabase Service: logs errors
- Supabase Service → Supabase: queries database
- Auth Provider → Auth Status API: provides session