{"id":50294735,"url":"https://github.com/chrisrobison/spynet","last_synced_at":"2026-05-28T08:04:00.654Z","repository":{"id":324651905,"uuid":"1093172914","full_name":"chrisrobison/spynet","owner":"chrisrobison","description":"A real-world espionage game powered by AR, AI, and geolocation","archived":false,"fork":false,"pushed_at":"2025-11-17T04:45:50.000Z","size":193,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-17T06:20:43.783Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chrisrobison.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"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-11-10T02:24:29.000Z","updated_at":"2025-11-17T04:45:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/chrisrobison/spynet","commit_stats":null,"previous_names":["chrisrobison/spynet"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/chrisrobison/spynet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisrobison%2Fspynet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisrobison%2Fspynet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisrobison%2Fspynet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisrobison%2Fspynet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chrisrobison","download_url":"https://codeload.github.com/chrisrobison/spynet/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chrisrobison%2Fspynet/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33599494,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-28T02:00:06.440Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":"2026-05-28T08:03:59.193Z","updated_at":"2026-05-28T08:04:00.649Z","avatar_url":"https://github.com/chrisrobison.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SpyNet AR\n\n**A location-based espionage game where your city becomes a living spy thriller**\n\n## Overview - Lean MVP\n\nSpyNet AR is a **web-based spy game** that combines physical QR code treasure hunting with faction-based territory control. Players become secret agents, completing missions at real-world locations to help their faction dominate the city.\n\n**Current Status**: Building a focused, playable MVP to validate core gameplay before investing in mobile apps and complex features.\n\n### Core Features (MVP)\n- **QR code missions** - Scan codes at physical locations using your browser\n- **Territory control** - Capture zones by completing missions in that area\n- **Faction warfare** - Join one of three rival agencies competing for dominance\n- **Web-based** - No app install needed, works on any mobile browser\n- **AI flavor text** - Mission briefings generated by AI for narrative immersion\n- **Progression system** - Earn XP, ranks, and credits through gameplay\n\n### What We're NOT Building (Yet)\n- ❌ Mobile apps (iOS/Android) - web-first approach\n- ❌ Augmented Reality - map-based instead\n- ❌ BLE proximity detection - manual encounters only\n- ❌ Real-time AI mission generation - pre-written missions\n- ❌ Complex infrastructure - simple VPS deployment\n\nThese features may come later if the MVP succeeds.\n\n## Game Concept\n\nPlayers start as **Independent Operatives**, completing missions to build reputation. As they progress, rival factions recruit them into a persistent shadow war:\n\n- **The Obsidian Order** - Masters of deception and psychological warfare\n- **The Aurora Syndicate** - Tech-forward anarchists specializing in digital infiltration\n- **The Citadel Directorate** - Military-precision loyalists focused on tactical operations\n\nPlayers can become **double agents**, switching sides or feeding false intel. The AI mission director creates emergent narratives where every action influences the global story.\n\n## Key Features\n\n### Location-Based Gameplay\n- AR overlay for discovering virtual items\n- GPS-tracked control zones at landmarks and neighborhoods\n- Real-world QR codes at bars, tourist spots, and hidden locations\n\n### Social \u0026 Competitive\n- Spot nearby agents using BLE proximity detection\n- Faction-based territory control wars\n- Cooperative and adversarial missions\n- Player-deployed QR codes for community-driven content\n\n### AI-Driven Narrative\n- LLM orchestrates dynamic mission generation\n- Personalized objectives based on player style\n- Emergent storylines from player actions\n- Real-time faction war adaptation\n\n### Accessibility\n- Field missions requiring physical exploration\n- Remote cyber missions (decryption, analysis, puzzles)\n- Strategic command roles for high-ranking agents\n- Full participation regardless of mobility\n\n## Tech Stack (Lean MVP)\n\n- **Frontend**: Vanilla JavaScript + Web Components (no build step)\n- **QR Scanning**: Browser WebRTC + jsQR library\n- **Maps**: Leaflet.js (open source)\n- **Backend**: Node.js + Fastify (dynamic routing)\n- **Database**: PostgreSQL 16 with PostGIS\n- **Caching**: Redis 7\n- **AI**: OpenAI/Local LLM for text generation (minimal usage)\n- **Hosting**: Single VPS ($20/mo) with Docker Compose\n- **No Kubernetes, no microservices, no complex infrastructure**\n\n## Project Structure\n\n```\nspynet/\n├── docs/               # Documentation\n│   ├── gameplay.md     # Game design document\n│   ├── tech-stack.md   # Technical architecture\n│   ├── api/            # API documentation\n│   └── schemas/        # Database and data schemas\n├── services/           # Backend microservices\n│   ├── api/            # Main API gateway\n│   ├── missions/       # Mission management\n│   ├── players/        # Player profiles and auth\n│   ├── factions/       # Faction system\n│   ├── zones/          # Control zone logic\n│   └── orchestrator/   # AI mission director (Python)\n├── apps/               # Frontend applications\n│   ├── mobile/         # React Native app\n│   └── web/            # Next.js web companion\n├── packages/           # Shared libraries\n├── infra/              # Infrastructure as code\n└── scripts/            # Utility scripts\n```\n\n## Getting Started\n\nSee [docs/SETUP.md](docs/SETUP.md) for development environment setup.\n\n## Documentation\n\n- [Game Design Document](docs/gameplay.md)\n- [Technical Architecture](docs/tech-stack.md)\n- [API Reference](docs/api/README.md)\n- [Database Schema](docs/schemas/database.md)\n- [Mission System](docs/mission-system.md)\n- [AI Orchestration](docs/ai-orchestration.md)\n\n## Roadmap (Lean MVP)\n\n### Phase 1: Playable Prototype (6 weeks)\n**Goal**: Prove the core loop is fun\n- Web frontend with QR scanner\n- Map view with zones\n- 5 pre-written missions\n- Basic faction system\n- Simple progression (XP, ranks)\n- **Test with 3 friends**\n\n### Phase 2: Multiplayer Beta (12 weeks)\n**Goal**: Get 10-20 active testers\n- Faction leaderboards\n- 20+ missions across city\n- Territory control visualization\n- Basic social features\n- **50% day-1 retention target**\n\n### Phase 3: Public Launch (20 weeks)\n**Goal**: Reach 50-100 active players\n- 30+ missions\n- Weekly faction challenges\n- PWA optimization\n- Community features\n- **Validate sustainable engagement**\n\n### Post-MVP (Only if Phase 3 succeeds)\n- Mobile apps\n- AR features\n- Real-time AI missions\n- Multi-city expansion\n\n## License\n\nTBD\n\n## Contact\n\nFor questions or partnership inquiries, contact: [TBD]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchrisrobison%2Fspynet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchrisrobison%2Fspynet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchrisrobison%2Fspynet/lists"}