{"id":22005408,"url":"https://github.com/jaycanuck/holidaygift2023","last_synced_at":"2026-05-05T19:31:50.082Z","repository":{"id":212217539,"uuid":"730974118","full_name":"JayCanuck/holidaygift2023","owner":"JayCanuck","description":"Cute little holiday gift webapp for the 2023 holidays, providing redeemable game code keys for specific users","archived":false,"fork":false,"pushed_at":"2023-12-21T01:48:53.000Z","size":3115,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-23T06:29:09.098Z","etag":null,"topics":["game-codes","gift","holiday","steam","winter","xmas"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/JayCanuck.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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}},"created_at":"2023-12-13T04:46:20.000Z","updated_at":"2024-12-07T01:56:18.000Z","dependencies_parsed_at":"2024-11-30T00:30:09.965Z","dependency_job_id":null,"html_url":"https://github.com/JayCanuck/holidaygift2023","commit_stats":null,"previous_names":["jaycanuck/holidaygift","jaycanuck/holidaygift2023"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/JayCanuck/holidaygift2023","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JayCanuck%2Fholidaygift2023","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JayCanuck%2Fholidaygift2023/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JayCanuck%2Fholidaygift2023/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JayCanuck%2Fholidaygift2023/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JayCanuck","download_url":"https://codeload.github.com/JayCanuck/holidaygift2023/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JayCanuck%2Fholidaygift2023/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273293875,"owners_count":25079892,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-02T02:00:09.530Z","response_time":77,"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":["game-codes","gift","holiday","steam","winter","xmas"],"created_at":"2024-11-30T00:19:48.393Z","updated_at":"2026-05-05T19:31:50.051Z","avatar_url":"https://github.com/JayCanuck.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HolidayGift greeting card/giftcode webapp\n\nI like to do cute surprises for friends around the holidays. For 2023, I decided to make a quick-n-dirty customized holiday gift website, which can provide customized message for predefined recipients as well as distribute preconfigured Steam game redeemable codes.\n\nRealistically, this also ended up as a fun testbed example single-page Next.js webapp.\n\n## Local development\n\nRun the development server:\n\n```bash\nnpm run dev\n# or\nyarn dev\n# or\npnpm dev\n# or\nbun dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) with your browser to see the result.\n\n## Environment Variable Setup\n\nThis project is designed to use 2 environment variables, `NEXT_PUBLIC_PARCHMENT_SVG` and `MYSTERY`.\n\n`NEXT_PUBLIC_PARCHMENT_SVG` is simply a string containing an SVG to be used as the parchment background for the gift messages.  It can be tailored to anything, though in my personal deployment I've use a papyrus scroll clipart SVG from [EmilTimplaru's Etsy shop](https://www.etsy.com/listing/955287962/papyrus-scroll-clipart-vector-design) as I liked that style.\n\nSecondly, there's a backend-only `MYSTERY` environment variable containing a stringified JSON value containing gift game codes and personalized metadata. This is the expected interface for the object:\n\n```ts\ninterface MysteryObject {\n  [userID: string]: {\n    name?: string; // recipient name\n    message?: string; // customized gift message to override default top message\n    games: {\n      name: string; // game name, not currently used anywhere\n      code: string; // redeemable game code value\n    }[]; // array of the game details\n  }\n}\n```\n\nFor example:\n\n```json\n{\n  \"00000000-0000-0000-0000-000000000000\":{\n    \"name\":\"Mr. Debug\",\n    \"message\":\"Test debug message.\",\n    \"games\":[\n      {\"name\":\"Game 1\",\"code\":\"00000-00000-00000\"},\n      {\"name\":\"Game 2\",\"code\":\"00000-00000-00000\"},\n      {\"name\":\"Game 3\",\"code\":\"00000-00000-00000\"}\n    ]\n  },\n  \"11111111-1111-1111-1111-111111111111\":{\n    \"games\":[\n      {\"name\":\"Game 1\",\"code\":\"00000-00000-00000\"},\n      {\"name\":\"Game 2\",\"code\":\"00000-00000-00000\"},\n      {\"name\":\"Game 3\",\"code\":\"00000-00000-00000\"}\n    ]\n  }\n}\n```\nThen stringify the JSON and store it as a `MYSTERY` environment variable.\n\nUser gifts can then be accessed via unique special `https://webserver/?id=\u003cuserID\u003e` URLs, while anyone visiting the webserver without the proper ID will just get a basic holiday greeting (no gift).\n\n# License\n\nBased on code [originally by Codrops](https://tympanus.net/codrops/2013/12/24/merry-christmas-with-a-bursting-gift-box/)\u003cbr\u003e \nCopyright 2013, Codrops http://www.codrops.com\u003cbr\u003e \nLicensed under the [MIT license](http://www.opensource.org/licenses/mit-license.php).\u003cbr\u003e \n\nNextjs Typescript ES6 port by Jason Robitaille with alterations to suit game gifting purpose\u003cbr\u003e \nCopyright 2023, Jason Robitaille\u003cbr\u003e \nUpdates licensed under the [Apache-2.0 license](https://www.apache.org/licenses/LICENSE-2.0.txt).\u003cbr\u003e \n\nMusic [\"Festive Fireside\" by Steve Oxen](https://www.fesliyanstudios.com/royalty-free-music/download/festive-fireside/3153)\u003cbr\u003e \nSound effects by https://pixabay.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaycanuck%2Fholidaygift2023","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjaycanuck%2Fholidaygift2023","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaycanuck%2Fholidaygift2023/lists"}