{"_id":"@codewithdan/ai-repo-adventures-generator","_rev":"8-d6df4d541d0f4d1be29a6de79fd7843d","name":"@codewithdan/ai-repo-adventures-generator","dist-tags":{"latest":"1.11.0"},"versions":{"1.9.0":{"name":"@codewithdan/ai-repo-adventures-generator","version":"1.9.0","keywords":["code-exploration","documentation","html-generator","adventure","storytelling","ai","llm","code-analysis","developer-tools"],"author":"Dan Wahlin","license":"MIT","_id":"@codewithdan/ai-repo-adventures-generator@1.9.0","maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"bin":{"repo-adventures":"./bin/cli.js"},"dist":{"shasum":"891daece8d839d464760ea80b90801fe23a36a27","tarball":"https://registry.npmjs.org/@codewithdan/ai-repo-adventures-generator/-/ai-repo-adventures-generator-1.9.0.tgz","fileCount":96,"integrity":"sha512-zmT7BnMxe7w50FRZghxqly0XMLf/5kpifNVy4BklCRN3/oQPALyBx0MWpsLIuK0K3LYAZLW/WuL/Z5gm77fUng==","signatures":[{"sig":"MEYCIQCLPZZ4GTGqbcGAKsuP+QFogAFw8ED7zkb5Ci5o5cGk9QIhAOwCHra/u0yEdMu57AzICPlL+DTigSASr/B3n0GJCbUR","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16951902},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"df1300eee5570014b2e03cd15e470216b3668fbf","scripts":{"build":"tsc && npm run copy-assets","clean":"rm -rf dist","watch":"tsc --watch","copy-assets":"cp -r src/cli/templates dist/cli/ && cp -r src/cli/assets dist/cli/ && cp -r src/cli/themes dist/cli/","prepublishOnly":"npm run build"},"_npmUser":{"name":"danwahlin","email":"dwahlin@hotmail.com"},"repository":{"url":"https://github.com/danwahlin/ai-repo-adventures.git","type":"git","directory":"packages/generator"},"_npmVersion":"lerna/8.2.3/node@v20.19.5+x64 (linux)","description":"Generate beautiful HTML adventure websites from your codebase","directories":{},"_nodeVersion":"20.19.5","dependencies":{"open":"^10.0.0","chalk":"^5.3.0","marked":"^12.0.0","commander":"^12.0.0","http-server":"^14.1.1","@codewithdan/ai-repo-adventures-core":"^1.8.11"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.5"},"_npmOperationalInternal":{"tmp":"tmp/ai-repo-adventures-generator_1.9.0_1759559925640_0.2840989391394988","host":"s3://npm-registry-packages-npm-production"}},"1.9.1":{"name":"@codewithdan/ai-repo-adventures-generator","version":"1.9.1","keywords":["code-exploration","documentation","html-generator","adventure","storytelling","ai","llm","code-analysis","developer-tools"],"author":"Dan Wahlin","license":"MIT","_id":"@codewithdan/ai-repo-adventures-generator@1.9.1","maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"bin":{"repo-adventures":"./bin/cli.js"},"dist":{"shasum":"8f4665763c26dcbeecd4b0666375796938252729","tarball":"https://registry.npmjs.org/@codewithdan/ai-repo-adventures-generator/-/ai-repo-adventures-generator-1.9.1.tgz","fileCount":96,"integrity":"sha512-SonJsD2QZ52lZYp6Rttx58LdFfi1ZcTyqRNt3e5LB+tm+1A2Cz4ia6gdiMU26d3hrkXrEViyFHTU21fm8FaLLg==","signatures":[{"sig":"MEUCIBjPQ7IDoelsEt3CIZftV8XGEaz3vgK0TjkE7FtR95P6AiEAjw0Io/L5mkHOZU0CdpVL/q97RkEzMeaHTEMvTc8L97Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16951902},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"05d7ef21eec719719287fcb7371ad6d17ba219c6","scripts":{"build":"tsc && npm run copy-assets","clean":"rm -rf dist","watch":"tsc --watch","copy-assets":"cp -r src/cli/templates dist/cli/ && cp -r src/cli/assets dist/cli/ && cp -r src/cli/themes dist/cli/","prepublishOnly":"npm run build"},"_npmUser":{"name":"danwahlin","email":"dwahlin@hotmail.com"},"repository":{"url":"https://github.com/danwahlin/ai-repo-adventures.git","type":"git","directory":"packages/generator"},"_npmVersion":"lerna/8.2.3/node@v20.19.5+x64 (linux)","description":"Generate beautiful HTML adventure websites from your codebase","directories":{},"_nodeVersion":"20.19.5","dependencies":{"open":"^10.0.0","chalk":"^5.3.0","marked":"^12.0.0","commander":"^12.0.0","http-server":"^14.1.1","@codewithdan/ai-repo-adventures-core":"^1.8.12"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.5"},"_npmOperationalInternal":{"tmp":"tmp/ai-repo-adventures-generator_1.9.1_1759561200624_0.9992626754837193","host":"s3://npm-registry-packages-npm-production"}},"1.9.2":{"name":"@codewithdan/ai-repo-adventures-generator","version":"1.9.2","keywords":["code-exploration","documentation","html-generator","adventure","storytelling","ai","llm","code-analysis","developer-tools"],"author":"Dan Wahlin","license":"MIT","_id":"@codewithdan/ai-repo-adventures-generator@1.9.2","maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"bin":{"repo-adventures":"./bin/cli.js"},"dist":{"shasum":"bf80db5b97347e641704c3b577d8a225f083cdae","tarball":"https://registry.npmjs.org/@codewithdan/ai-repo-adventures-generator/-/ai-repo-adventures-generator-1.9.2.tgz","fileCount":96,"integrity":"sha512-nOreVoKwxipu9+xGRcqifnbv2O/YAensZShbltdPZ/Cat25pR5qz1s+ioN69ff61KUE/F3g3RD1SYnQjrqRRjA==","signatures":[{"sig":"MEYCIQDSgVJya6AR10Fx0EAHTpmdXtOtHM3H7IIyU7w5Kc7dawIhAO2JJqSZbBEKGaNG57CJKBpiVz5KcahVfbmkkVTNwIsN","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16951904},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"480448e45d9e23f1944f32b169c283464808c317","scripts":{"build":"tsc && npm run copy-assets","clean":"rm -rf dist","watch":"tsc --watch","copy-assets":"cp -r src/cli/templates dist/cli/ && cp -r src/cli/assets dist/cli/ && cp -r src/cli/themes dist/cli/","prepublishOnly":"npm run build"},"_npmUser":{"name":"danwahlin","email":"dwahlin@hotmail.com"},"repository":{"url":"https://github.com/danwahlin/ai-repo-adventures.git","type":"git","directory":"packages/generator"},"_npmVersion":"lerna/8.2.3/node@v20.19.5+x64 (linux)","description":"Generate beautiful HTML adventure websites from your codebase","directories":{},"_nodeVersion":"20.19.5","dependencies":{"open":"^10.0.0","chalk":"^5.3.0","marked":"^12.0.0","commander":"^12.0.0","http-server":"^14.1.1","@codewithdan/ai-repo-adventures-core":"^1.8.13"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.5"},"_npmOperationalInternal":{"tmp":"tmp/ai-repo-adventures-generator_1.9.2_1759561971940_0.27201870471192224","host":"s3://npm-registry-packages-npm-production"}},"1.10.0":{"name":"@codewithdan/ai-repo-adventures-generator","version":"1.10.0","keywords":["code-exploration","documentation","html-generator","adventure","storytelling","ai","llm","code-analysis","developer-tools"],"author":"Dan Wahlin","license":"MIT","_id":"@codewithdan/ai-repo-adventures-generator@1.10.0","maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"bin":{"repo-adventures":"./bin/cli.js"},"dist":{"shasum":"5ec27dd1a6b44258ca69629ee81ebca6d7165f3d","tarball":"https://registry.npmjs.org/@codewithdan/ai-repo-adventures-generator/-/ai-repo-adventures-generator-1.10.0.tgz","fileCount":96,"integrity":"sha512-UkxuJqdPJTORO9GpqmLue92PYrX3k7eP3WC7OR9L7OZDO0UBYRcJ6QZfKwXJ7ZJs5i9B1WlyGSdukTwUORMyUA==","signatures":[{"sig":"MEUCIC3gLzUNhNGmVNH3sGcgCZb2RtNJpKs9hRzMYyvWMZL1AiEA5Hwb2WcQn4LnInr3+y02Dy4GbDSOInKySCCU7Op6Uqo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16955073},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"7d56881441b2734c4feadcc249507d4ecb6da827","scripts":{"build":"tsc && npm run copy-assets","clean":"rm -rf dist","watch":"tsc --watch","copy-assets":"cp -r src/cli/templates dist/cli/ && cp -r src/cli/assets dist/cli/ && cp -r src/cli/themes dist/cli/","prepublishOnly":"npm run build"},"_npmUser":{"name":"danwahlin","email":"dwahlin@hotmail.com"},"repository":{"url":"https://github.com/danwahlin/ai-repo-adventures.git","type":"git","directory":"packages/generator"},"_npmVersion":"lerna/8.2.4/node@v20.19.5+x64 (linux)","description":"Generate beautiful HTML adventure websites from your codebase","directories":{},"_nodeVersion":"20.19.5","dependencies":{"open":"^10.2.0","chalk":"^5.6.2","marked":"^16.3.0","commander":"^14.0.1","http-server":"^14.1.1","@codewithdan/ai-repo-adventures-core":"^1.10.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^24.6.2"},"_npmOperationalInternal":{"tmp":"tmp/ai-repo-adventures-generator_1.10.0_1759563214418_0.952370682475213","host":"s3://npm-registry-packages-npm-production"}},"1.10.1":{"name":"@codewithdan/ai-repo-adventures-generator","version":"1.10.1","keywords":["code-exploration","documentation","html-generator","adventure","storytelling","ai","llm","code-analysis","developer-tools"],"author":{"name":"Dan Wahlin"},"license":"MIT","_id":"@codewithdan/ai-repo-adventures-generator@1.10.1","maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"bin":{"repo-adventures":"bin/cli.js"},"dist":{"shasum":"aead11fd4aa5832be34081e7cf987b38ee686328","tarball":"https://registry.npmjs.org/@codewithdan/ai-repo-adventures-generator/-/ai-repo-adventures-generator-1.10.1.tgz","fileCount":96,"integrity":"sha512-tSEv6UUYnC1RBeE0BUhHo7b175vZgBVIbgAIcMuMeJvzdSJYWoHAtoHSbVLI7zTEf/Gvp+q4HTKslg798PY5FA==","signatures":[{"sig":"MEYCIQCmXkmKIWT0L8FYTSsQ+44Nl+1//YxttD57fZO2M5wQbAIhAKyFTPgaEiR93KMjxzU6mo4U8x0maFdaTHh70YW7HPUO","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16955073},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"b596d856c3605e68979316769f727333fb33ebcb","scripts":{"build":"tsc && npm run copy-assets","clean":"rm -rf dist","watch":"tsc --watch","copy-assets":"cp -r src/cli/templates dist/cli/ && cp -r src/cli/assets dist/cli/ && cp -r src/cli/themes dist/cli/","prepublishOnly":"npm run build"},"_npmUser":{"name":"danwahlin","email":"dwahlin@hotmail.com"},"repository":{"url":"git+https://github.com/danwahlin/ai-repo-adventures.git","type":"git","directory":"packages/generator"},"_npmVersion":"lerna/9.0.0/node@v20.19.5+x64 (linux)","description":"Generate beautiful HTML adventure websites from your codebase","directories":{},"_nodeVersion":"20.19.5","dependencies":{"open":"^10.2.0","chalk":"^5.6.2","marked":"^16.3.0","commander":"^14.0.1","http-server":"^14.1.1","@codewithdan/ai-repo-adventures-core":"^1.10.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^24.6.2"},"_npmOperationalInternal":{"tmp":"tmp/ai-repo-adventures-generator_1.10.1_1759563681217_0.46230814879020854","host":"s3://npm-registry-packages-npm-production"}},"1.10.2":{"name":"@codewithdan/ai-repo-adventures-generator","version":"1.10.2","keywords":["code-exploration","documentation","html-generator","adventure","storytelling","ai","llm","code-analysis","developer-tools"],"author":{"name":"Dan Wahlin"},"license":"MIT","_id":"@codewithdan/ai-repo-adventures-generator@1.10.2","maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"bin":{"repo-adventures":"bin/cli.js"},"dist":{"shasum":"f5fe75ff640285267fd4ad2886406f0941e05e7b","tarball":"https://registry.npmjs.org/@codewithdan/ai-repo-adventures-generator/-/ai-repo-adventures-generator-1.10.2.tgz","fileCount":96,"integrity":"sha512-kGEjArTupstgSrpfILZsXmB7WiE77xxKtrpaRsFxw85gMvxUjoWF/uPz3X4SrFCRVD6n257sLy9iuADGdozADA==","signatures":[{"sig":"MEQCIFeUlykK+5aGVWUmrzySwbgwZPpSYUm89CS4sy2yuWNMAiAPphuRq4oQTbZuQOrrmkFHMP5Hab5vkBQKxkYy6HhBRA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16955073},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"46650e5bf71b6c1ac9db8ae5d76f49d9b36c49fe","scripts":{"build":"tsc && npm run copy-assets","clean":"rm -rf dist","watch":"tsc --watch","copy-assets":"cp -r src/cli/templates dist/cli/ && cp -r src/cli/assets dist/cli/ && cp -r src/cli/themes dist/cli/","prepublishOnly":"npm run build"},"_npmUser":{"name":"danwahlin","email":"dwahlin@hotmail.com"},"repository":{"url":"git+https://github.com/danwahlin/ai-repo-adventures.git","type":"git","directory":"packages/generator"},"_npmVersion":"lerna/9.0.0/node@v20.19.5+x64 (linux)","description":"Generate beautiful HTML adventure websites from your codebase","directories":{},"_nodeVersion":"20.19.5","dependencies":{"open":"^10.2.0","chalk":"^5.6.2","marked":"^16.3.0","commander":"^14.0.1","http-server":"^14.1.1","@codewithdan/ai-repo-adventures-core":"^1.10.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^24.6.2"},"_npmOperationalInternal":{"tmp":"tmp/ai-repo-adventures-generator_1.10.2_1759601276860_0.6483325795868904","host":"s3://npm-registry-packages-npm-production"}},"1.10.3":{"name":"@codewithdan/ai-repo-adventures-generator","version":"1.10.3","keywords":["code-exploration","documentation","html-generator","adventure","storytelling","ai","llm","code-analysis","developer-tools"],"author":{"name":"Dan Wahlin"},"license":"MIT","_id":"@codewithdan/ai-repo-adventures-generator@1.10.3","maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"bin":{"repo-adventures":"bin/cli.js"},"dist":{"shasum":"bc78986910b041d0ca9b2e345239ba8dc4aa0bd9","tarball":"https://registry.npmjs.org/@codewithdan/ai-repo-adventures-generator/-/ai-repo-adventures-generator-1.10.3.tgz","fileCount":96,"integrity":"sha512-R6OhB7AXKNxf/LOBI/PTyfm0oFe2OQslu5hvOAx6JAyjTwKRB+GugHWS2CvRCIG9czimOKWxIkcRdxdrTXZq4Q==","signatures":[{"sig":"MEUCIQDcoK5CzxBOR24b2+Zekb8PKV6x+7fMieY55ZH9jmZC+wIgI0AtlbS+1u0OqjEaRqWJu3z29mbCuT0VwsS9uTUB110=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16955033},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"28b1101719135ea06f732ea50d0b303081f234c3","scripts":{"build":"tsc && npm run copy-assets","clean":"rm -rf dist","watch":"tsc --watch","copy-assets":"cp -r src/cli/templates dist/cli/ && cp -r src/cli/assets dist/cli/ && cp -r src/cli/themes dist/cli/","prepublishOnly":"npm run build"},"_npmUser":{"name":"danwahlin","email":"dwahlin@hotmail.com"},"repository":{"url":"git+https://github.com/danwahlin/ai-repo-adventures.git","type":"git","directory":"packages/generator"},"_npmVersion":"lerna/9.0.0/node@v20.19.5+x64 (linux)","description":"Generate beautiful HTML adventure websites from your codebase","directories":{},"_nodeVersion":"20.19.5","dependencies":{"open":"^10.2.0","chalk":"^5.6.2","marked":"^16.3.0","commander":"^14.0.1","http-server":"^14.1.1","@codewithdan/ai-repo-adventures-core":"^1.10.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^24.6.2"},"_npmOperationalInternal":{"tmp":"tmp/ai-repo-adventures-generator_1.10.3_1759609516865_0.8673642082712261","host":"s3://npm-registry-packages-npm-production"}},"1.11.0":{"name":"@codewithdan/ai-repo-adventures-generator","version":"1.11.0","description":"Generate beautiful HTML adventure websites from your codebase","type":"module","bin":{"repo-adventures":"bin/cli.js"},"main":"./dist/index.js","types":"./dist/index.d.ts","scripts":{"build":"tsc && npm run copy-assets","copy-assets":"cp -r src/cli/templates dist/cli/ && cp -r src/cli/assets dist/cli/ && cp -r src/cli/themes dist/cli/","clean":"rm -rf dist","watch":"tsc --watch","prepublishOnly":"npm run build"},"keywords":["code-exploration","documentation","html-generator","adventure","storytelling","ai","llm","code-analysis","developer-tools"],"author":{"name":"Dan Wahlin"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/danwahlin/ai-repo-adventures.git","directory":"packages/generator"},"homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"dependencies":{"@codewithdan/ai-repo-adventures-core":"^1.10.3","chalk":"^5.6.2","commander":"^14.0.1","http-server":"^14.1.1","marked":"^16.3.0","open":"^10.2.0"},"devDependencies":{"@types/node":"^24.6.2","typescript":"^5.9.3"},"engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"gitHead":"d605734886598de22e2211165ad273de32670e08","_id":"@codewithdan/ai-repo-adventures-generator@1.11.0","_nodeVersion":"20.19.5","_npmVersion":"lerna/9.0.0/node@v20.19.5+x64 (linux)","dist":{"integrity":"sha512-LDtjuGPIZgiJJJhTnEh8vFgbvnmuzU0bVaX8dW4C4ECSRTXEKwUXJm0IZJT+zDBqWDDQrTh6I6Tcmyr0HsMABA==","shasum":"63c10e919b3427de35f88e4cd08ff6cbf3c671f0","tarball":"https://registry.npmjs.org/@codewithdan/ai-repo-adventures-generator/-/ai-repo-adventures-generator-1.11.0.tgz","fileCount":140,"unpackedSize":17002314,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCxMWAYuEtfO6c+kGsAG4xHxoNY33pul+AJTdsgQFeNjAIhANh5jPGsL5+JK7OVyN3CwZo59P0SIo/JQUwsA4+csQAK"}]},"_npmUser":{"name":"danwahlin","email":"dwahlin@hotmail.com"},"directories":{},"maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ai-repo-adventures-generator_1.11.0_1761284023616_0.7205862088312471"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-04T06:38:45.558Z","modified":"2025-10-24T05:33:44.303Z","1.9.0":"2025-10-04T06:38:46.075Z","1.9.1":"2025-10-04T07:00:01.030Z","1.9.2":"2025-10-04T07:12:52.363Z","1.10.0":"2025-10-04T07:33:34.823Z","1.10.1":"2025-10-04T07:41:21.610Z","1.10.2":"2025-10-04T18:07:57.261Z","1.10.3":"2025-10-04T20:25:17.271Z","1.11.0":"2025-10-24T05:33:44.095Z"},"bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"author":{"name":"Dan Wahlin"},"license":"MIT","homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","keywords":["code-exploration","documentation","html-generator","adventure","storytelling","ai","llm","code-analysis","developer-tools"],"repository":{"type":"git","url":"git+https://github.com/danwahlin/ai-repo-adventures.git","directory":"packages/generator"},"description":"Generate beautiful HTML adventure websites from your codebase","maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"readme":"# @codewithdan/ai-repo-adventures-generator\n\nGenerate beautiful, interactive HTML adventure websites from your codebase! Transform your code repository into an engaging story-based exploration experience.\n\n## Features\n\n- šŸŽØ **4 Built-in Themes**: Space, Mythical, Ancient, and Developer (plus Custom theme support)\n- šŸŒ **Complete HTML Website**: Fully self-contained with embedded CSS and assets\n- šŸ“± **Responsive Design**: Mobile-first approach with beautiful gradient styling\n- šŸš€ **Auto-Launch**: Built-in development server with automatic browser opening\n- šŸ¤– **AI-Powered Stories**: Uses LLMs to generate personalized narratives\n- šŸŽÆ **GitHub Integration**: Automatic linking to source files on GitHub\n- āš” **Fast Generation**: Optimized with caching and parallel multi-theme processing\n- šŸ”§ **Flexible Configuration**: Quest limiting, output control, and debugging options\n\n## Installation\n\n```bash\nnpm install -g @codewithdan/ai-repo-adventures-generator\n```\n\nOr use directly with npx:\n\n```bash\nnpx @codewithdan/ai-repo-adventures-generator\n```\n\n## Usage\n\n### Interactive Mode\n\nSimply run the command in your project directory:\n\n```bash\nrepo-adventures\n```\n\nThis will guide you through:\n1. Choosing a theme (including \"Generate All Themes\" option)\n2. Selecting an output directory\n3. Generating your adventure website\n\n### Command-Line Options\n\n```bash\nrepo-adventures [options]\n\nOptions:\n --theme Theme: space, mythical, ancient, developer, custom, or all\n --output Output directory (default: ./public)\n --overwrite Overwrite existing files without prompting\n --max-quests Limit number of quests to generate (default: all)\n --log-llm-output Save raw LLM output to tests/llm-output directory\n --serve Start HTTP server and open browser after generation\n --help, -h Show help message\n\nExamples:\n repo-adventures --theme space --output ./docs --overwrite\n repo-adventures --theme all --output ./public --overwrite # Generate all themes\n repo-adventures --theme mythical --max-quests 3 --serve # Limit quests and auto-serve\n```\n\n## Configuration\n\n### LLM Setup (Required)\n\nThe generator requires LLM configuration to generate stories and adventure content.\n\nCreate a `.env` file in your project:\n\n```bash\n# OpenAI\nREPO_ADV_LLM_API_KEY=your_openai_key_here\nREPO_ADV_LLM_BASE_URL=https://api.openai.com/v1\nREPO_ADV_LLM_MODEL=gpt-4o\n\n# Azure AI foundry\nREPO_ADV_LLM_API_KEY=\nREPO_ADV_LLM_BASE_URL=https://.openai.azure.com\nREPO_ADV_LLM_MODEL=gpt-4o\nREPO_ADV_LLM_API_VERSION=2025-01-01-preview\n\n# Or GitHub Models (free tier - very limited and can only be used with very small adventures)\nGITHUB_TOKEN=your_github_token_here\nREPO_ADV_LLM_BASE_URL=https://models.inference.ai.azure.com\nREPO_ADV_LLM_MODEL=gpt-4o\n\n# Or Local Ollama (results can vary and may not generate compatible output - you can try it! :-))\nREPO_ADV_LLM_BASE_URL=http://localhost:11434/v1\nREPO_ADV_LLM_API_KEY=ollama\nREPO_ADV_LLM_MODEL=gemma3:27b\nLLM_REQUEST_TIMEOUT=300000 # 5 minutes for slower local models\n```\n\n### Adventure Configuration\n\nCreate an `adventure.config.json` in your project root to guide quest generation. This file tells the AI which parts of your codebase are most important to explore.\n\n```json\n{\n \"adventure\": {\n \"name\": \"Your Project Name\",\n \"description\": \"Brief description of what your project does\",\n \"url\": \"https://github.com/yourusername/yourrepo\",\n \"customInstructions\": \"[Optional: Any specific guidance for story generation]\",\n \"quests\": [\n {\n \"title\": \"Core Features\",\n \"description\": \"Explore the main functionality\",\n \"files\": [\n {\n \"path\": \"src/main.ts\",\n \"description\": \"Main entry point\",\n \"highlights\": [\n {\n \"name\": \"initializeApp\",\n \"description\": \"Application initialization\"\n }\n ]\n }\n ]\n }\n ]\n }\n}\n```\n\n## Generated Output\n\nThe generator creates:\n\n```\noutput-directory/\nā”œā”€ā”€ index.html # Main adventure page with story\nā”œā”€ā”€ quest-1.html # Individual quest pages \nā”œā”€ā”€ quest-2.html\nā”œā”€ā”€ quest-N.html # Dynamic number based on your codebase\nā”œā”€ā”€ summary.html # Adventure completion summary\nā””ā”€ā”€ assets/\n ā”œā”€ā”€ theme.css # Combined theme + base + animations CSS\n ā”œā”€ā”€ quest-navigator.js # Interactive navigation component\n ā”œā”€ā”€ quest-navigator.css\n ā”œā”€ā”€ compass-icon.svg\n ā”œā”€ā”€ images/\n ā”‚ ā””ā”€ā”€ (theme-specific images)\n ā””ā”€ā”€ shared/\n ā”œā”€ā”€ github-mark.svg # Dark GitHub logo\n ā””ā”€ā”€ github-mark-white.svg # White GitHub logo\n```\n\n## Create adventure.config.json (AI Assistant Prompt)\n\nUse this prompt with any AI coding assistant to generate a custom `adventure.config.json` file for your project:\n\n---\n\n**COPY AND PASTE THIS PROMPT:**\n\n```\nPlease analyze this codebase and create an adventure.config.json file at the root of the project to help users explore the project through guided quests.\n\nRequirements:\n- Identify 3-5 key areas of functionality in the codebase\n- Select 2-4 representative files for each area\n- Highlight 2-4 important functions/classes or other members per file\n- Focus on entry points, main logic, and system integrations\n\nUse this exact JSON structure:\n\n{\n \"adventure\": {\n \"name\": \"[Your Project Name]\",\n \"description\": \"[Brief project description]\", \n \"url\": \"https://github.com/[username]/[repo-name]\",\n \"customInstructions\": \"[Optional: Any specific guidance for story generation]\",\n \"quests\": [\n {\n \"title\": \"[Quest Name - e.g. 'Authentication System']\",\n \"description\": \"[What users learn from exploring this area]\",\n \"files\": [\n {\n \"path\": \"[relative/path/to/important/file.js]\",\n \"description\": \"[Role of this file in the system]\",\n \"highlights\": [\n {\n \"name\": \"[functionName or ClassName.method]\", \n \"description\": \"[What this code does and why it matters]\"\n }\n ]\n }\n ]\n }\n ]\n }\n}\n\nPrioritize files that contain:\nāœ“ Main entry points (index.js, program.cs, main.ts, app.js, etc.)\nāœ“ Core business logic and algorithms \nāœ“ API routes and controllers\nāœ“ Database models and data access\nāœ“ Configuration and setup code\nāœ“ Key middleware and utilities\n\nAvoid:\nāœ— Test files, build scripts, or configuration-only files\nāœ— Simple utility functions without business logic\nāœ— Auto-generated or boilerplate code\n\nAim for 15-25 total highlights across all quests for the best exploration experience.\n```\n\n---\n\n**The generated file will enable:**\n- šŸŽÆ **Guided Exploration**: Step-by-step tours through your most important code\n- šŸ“š **Educational Context**: AI-generated explanations of how your systems work\n- šŸŽØ **Themed Adventures**: Space, mythical, ancient, or developer-themed code tours\n- šŸŒ **Shareable Websites**: Beautiful HTML adventures for documentation and onboarding\n\n## Themes\n\n### Built-in Themes\n\n- **Space** šŸš€ - Explore your code as a cosmic space adventure\n- **Mythical** šŸ§™ā€ā™‚ļø - Journey through a magical enchanted kingdom \n- **Ancient** šŸ›ļø - Discover ancient archaeological civilizations\n- **Developer** šŸ’» - Modern tech-focused professional exploration\n- **Custom** šŸŽØ - Create your own personalized theme\n- **All Themes** āš” - Generate all themes simultaneously with parallel processing\n\n### Custom Themes\n\nWhen selecting \"custom\" theme, you'll be prompted to provide:\n- Theme name\n- Description\n- Keywords for storytelling\n\n## Requirements\n\n- Node.js 20 or higher\n- A GitHub code repository to explore\n- LLM API key for AI-generated content\n\n## License\n\nMIT\n\n## Author\n\nDan Wahlin\n\n## Links\n\n- [GitHub Repository](https://github.com/danwahlin/ai-repo-adventures)\n- [Report Issues](https://github.com/danwahlin/ai-repo-adventures/issues)","readmeFilename":"README.md"}