{"id":34778777,"url":"https://github.com/zot/hollow-world","last_synced_at":"2026-05-26T05:37:36.401Z","repository":{"id":315138510,"uuid":"1058222802","full_name":"zot/hollow-world","owner":"zot","description":"ttrpg support app for the Hollow tabletop role playing game","archived":false,"fork":false,"pushed_at":"2025-11-13T21:20:05.000Z","size":78445,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-13T23:24:12.034Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-16T19:43:43.000Z","updated_at":"2025-11-13T21:20:10.000Z","dependencies_parsed_at":"2025-09-17T00:09:11.699Z","dependency_job_id":null,"html_url":"https://github.com/zot/hollow-world","commit_stats":null,"previous_names":["zot/hollow-world"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zot/hollow-world","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zot%2Fhollow-world","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zot%2Fhollow-world/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zot%2Fhollow-world/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zot%2Fhollow-world/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zot","download_url":"https://codeload.github.com/zot/hollow-world/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zot%2Fhollow-world/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33506509,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T03:12:49.672Z","status":"ssl_error","status_checked_at":"2026-05-26T03:12:47.976Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-12-25T08:44:08.356Z","updated_at":"2026-05-26T05:37:36.389Z","avatar_url":"https://github.com/zot.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🏜️ Hollow World\n\n**[https://github.com/zot/hollow-world](https://github.com/zot/hollow-world)**\n\nA P2P web-based RPG client for the Hollow frontier game system.\n\n## 🌵 Overview\n\nWelcome to Hollow World - a single-page web application that brings the mysterious frontier of the Hollow RPG system to life. Create characters, manage your outlaw personas, and connect with other players in this peer-to-peer western adventure.\n\n## 📐 3-layer development\n\nThis project uses **CRC (Class-Responsibility-Collaboration) modeling** for design and development. The CRC infrastructure and tooling developed here has been extracted into a standalone project: **[claude-crc](https://github.com/zot/claude-crc)** - a reusable framework for CRC-driven development with Claude Code.\n\n**NOTE:** this project has not yet upgraded to **[mini-spec](https://github.com/zot/mini-spec)**.\n\n## ✅ Current Implementation Status\n\n### **Real P2P Network Integration**\n- **Real Peer ID**: Display actual libp2p peer ID instead of mock\n- **Persistent Network**: Peer ID persists across sessions using stored private key\n- **Selectable Peer ID**: Click to select full peer ID text\n\n### **Comprehensive Character System**\n- **Full Hollow RPG Integration**: Uses complete `ICharacter` interface with all 8 attributes\n- **Proper Character Storage**: UUID-based persistence with comprehensive character data\n- **Character Manager**: List view with character stats, attributes, and skull/crossbones delete buttons\n- **Character Editor**: Full editor with character preview and Yep/Nope buttons\n\n### **Advanced Routing \u0026 History**\n- **URL-Based Navigation**: Each view has its own path (`/`, `/characters`, `/character/[id]`)\n- **Browser History Support**: Back/forward buttons work correctly across all views\n- **History Management**: Proper state management for character editing sessions\n\n### **Western-Themed UI**\n- **Consistent Styling**: Sancreek fonts, medium-light brown text (#8B7355)\n- **Old-Timey Design**: Dime novel aesthetic across all components\n- **Responsive Layout**: Works on desktop and mobile devices\n\n### **Audio System**\n- **Gunshot Sounds**: Random pitch/duration variations with interruption\n- **Background Music**: Western ghosttown music loops automatically\n- **Audio Feedback**: All buttons provide gunshot sound feedback\n\n## 🚀 Getting Started\n\n```bash\nnpm install\nnpm run dev\n```\n\nVisit `http://localhost:3000` to start your frontier adventure.\n\n## 📋 Specifications\n\nThe application follows comprehensive specifications located in:\n\n- [`specs/main.md`](specs/main.md) - Overall application architecture\n- [`specs/ui.splash.md`](specs/ui.splash.md) - Splash screen requirements\n- [`specs/ui.characters.md`](specs/ui.characters.md) - Character management system\n- [`specs/p2p.md`](specs/p2p.md) - Peer-to-peer networking requirements\n- [`specs/character-sheet-plan.md`](specs/character-sheet-plan.md) - Character sheet component design\n- [`specs/main-plan.md`](specs/main-plan.md) - Detailed implementation plan and progress\n\n## 🎯 Features\n\n- **Don't Go Hollow**: Atmospheric splash screen with green glowing title\n- **Character Creation**: Create and manage frontier outlaws with full RPG stats\n- **P2P Networking**: Connect with other players using persistent peer IDs\n- **Browser Navigation**: Full back/forward button support with URL routing\n- **Western Audio**: Immersive gunshot effects and mysterious frontier music\n- **Responsive Design**: Works seamlessly on all devices\n\n## 🛠 Technical Architecture\n\nBuilt with:\n- **TypeScript** - Type-safe development following SOLID principles\n- **Vite** - Fast development and build tooling\n- **LibP2P** - Decentralized peer-to-peer networking\n- **Vitest** - Comprehensive unit testing\n- **Web Audio API** - Rich audio effects and background music\n\n## 🧪 Testing\n\n```bash\nnpm test         # Run unit tests\nnpm run test:ui  # Run tests with UI\n```\n\n---\n\n## 📜 Historical Note\n\nThe CRC (Class-Responsibility-Collaboration) methodology and tooling used in this project was originally developed as part of HollowWorld's design process. As the CRC infrastructure matured, it was extracted into the standalone **[claude-crc](https://github.com/zot/claude-crc)** project to make it reusable for other Claude Code projects. The CRC system provides a three-tier documentation approach (Level 1 specs → Level 2 design models → Level 3 implementation) with comprehensive traceability and gap analysis tools.\n\n---\n\n*Don't go hollow out there, partner. The frontier's got secrets that'll chill your bones.* 🌵💀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzot%2Fhollow-world","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzot%2Fhollow-world","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzot%2Fhollow-world/lists"}