{"id":47790696,"url":"https://github.com/deadronos/northpole-mail","last_synced_at":"2026-04-03T15:36:34.099Z","repository":{"id":330149424,"uuid":"1121755958","full_name":"deadronos/northpole-mail","owner":"deadronos","description":"Santa NorthPoleMail IT Support","archived":false,"fork":false,"pushed_at":"2025-12-23T16:54:50.000Z","size":1716,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-25T03:56:32.720Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://deadronos.github.io/northpole-mail/","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/deadronos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.MD","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-12-23T13:57:30.000Z","updated_at":"2025-12-23T16:54:09.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/deadronos/northpole-mail","commit_stats":null,"previous_names":["deadronos/northpole-mail"],"tags_count":2,"template":false,"template_full_name":"google-gemini/aistudio-repository-template","purl":"pkg:github/deadronos/northpole-mail","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deadronos%2Fnorthpole-mail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deadronos%2Fnorthpole-mail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deadronos%2Fnorthpole-mail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deadronos%2Fnorthpole-mail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deadronos","download_url":"https://codeload.github.com/deadronos/northpole-mail/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deadronos%2Fnorthpole-mail/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31360807,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T15:19:21.178Z","status":"ssl_error","status_checked_at":"2026-04-03T15:19:20.670Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":"2026-04-03T15:36:33.713Z","updated_at":"2026-04-03T15:36:34.089Z","avatar_url":"https://github.com/deadronos.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NorthPole Mail — Santa's IT Helpdesk 🎅🎮\n\n**A small, local, meme-y browser game where you play Senior Support Engineer Claus and troubleshoot ridiculous North Pole helpdesk tickets.**\n\n![Demo Screenshot](image.png)\n\n---\n\n## 🎯 What is this?\n\nThis is a playful single-player browser game built for local entertainment and demos. Tickets from reindeer, elves, and holiday characters arrive in your queue — you read the problem, respond (type or use canned replies), and the game scores you based on relevance and charm.\n\n- The theme is intentionally meme-y: canned jokes like \"It's always DNS\" and cheeky responses make the experience light and funny.\n- The evaluation is local and deterministic (see Developer Notes).\n\n## Quick Start — Run locally ✅\n\n**Prerequisites:** Node.js\n\n1. Install dependencies:\n\n   ```bash\n   npm install\n   ```\n\n2. Start the dev server:\n\n   ```bash\n   npm run dev\n   ```\n\n3. Open your browser to: `http://localhost:3000`\n\n\u003e Note: The game runs fully locally. You do **not** need an API key. (There is an optional `GEMINI_API_KEY` placeholder in `vite.config.ts` if you want to experiment with AI integrations later.)\n\n## How to Play — TL;DR 🕹️\n\n1. Click an **Active Ticket** on the left.\n2. Read the ticket body and choose a canned response or type your own solution.\n3. Click **Send Solution**. The system evaluates your reply and gives a rating and comment.\n4. Watch your **Score**, **Satisfaction**, and **Stress** in the header — try to keep satisfaction high and stress low!\n\n**Tip:** Using relevant technical keywords (e.g., `dns`, `reboot`, `database`, `sudo`) usually gets better ratings.\n\n## How it works / Developer Notes 🔧\n\n- Stack: **React**, **TypeScript**, **Vite**, and **Tailwind** (via CDN). Minimal and easy to run.\n- Where to look:\n  - `App.tsx` — main UI \u0026 state management\n  - `components/Terminal.tsx` — terminal UI and logs\n  - `components/StatsHeader.tsx` — score / stats UI\n  - `services/geminiService.ts` — ticket generation \u0026 response evaluation logic\n  - `constants.ts` — `TICKET_POOL` \u0026 `CANNED_RESPONSES` (edit here to add custom tickets or jokes)\n\n- Scoring: `evaluateLocalResponse` matches reply text against ticket keywords and applies rating/satisfaction/stress impacts. Customize behavior in `services/geminiService.ts`.\n\n## Responsive \u0026 Accessibility Notes 📱\n\n- The layout is mobile-friendly: terminals are shorter on small screens, logs wrap to prevent horizontal scrolling, and footer content stacks.\n- If you hit layout issues on very small devices, please open an issue and attach a screenshot.\n\n## Contributing ✨\n\n1. Fork the repo\n2. Create a branch with a short, descriptive name\n3. Open a PR with a clear summary\n\nKeep changes focused. If you extend game logic, include unit tests for `services/geminiService.ts`.\n\n## License \u0026 Credits\n\nMIT — see `LICENSE.MD` for details.\n\nBuilt with holiday cheer by deadronos. Pull requests, jokes, and cookies welcome. 🎁\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeadronos%2Fnorthpole-mail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeadronos%2Fnorthpole-mail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeadronos%2Fnorthpole-mail/lists"}