{"id":34080356,"url":"https://github.com/aep-dev/site-generator","last_synced_at":"2026-04-09T04:04:27.179Z","repository":{"id":256089207,"uuid":"854297391","full_name":"aep-dev/site-generator","owner":"aep-dev","description":"the aep.dev site generator. ","archived":false,"fork":false,"pushed_at":"2026-03-01T18:32:53.000Z","size":2562,"stargazers_count":1,"open_issues_count":11,"forks_count":5,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-03-25T03:12:51.879Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://aep.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aep-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2024-09-08T22:24:59.000Z","updated_at":"2026-03-01T18:32:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"368da427-146a-4970-9289-d49b86880941","html_url":"https://github.com/aep-dev/site-generator","commit_stats":null,"previous_names":["aep-dev/site-generator-beta","aep-dev/site-generator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aep-dev/site-generator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aep-dev%2Fsite-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aep-dev%2Fsite-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aep-dev%2Fsite-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aep-dev%2Fsite-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aep-dev","download_url":"https://codeload.github.com/aep-dev/site-generator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aep-dev%2Fsite-generator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31584820,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"online","status_checked_at":"2026-04-09T02:00:06.848Z","response_time":112,"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":"2025-12-14T11:56:28.902Z","updated_at":"2026-04-09T04:04:27.174Z","avatar_url":"https://github.com/aep-dev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AEP Site Generator\n\n## Overview\n\nThe AEP Site Generator takes in all of our documentation from multiple\nrepositories and generates the AEP website.\n\nThe site generator is made of multiple parts:\n\n- A CI workflow\n- A generator script that reads the various repos + converts their\n  documentation to formats supported by Starlight\n- A (very standard) [Starlight](https://starlight.astro.build) website.\n\n## Generator\n\nThe generator script reads documentation from all of the repos and writes files\nfor Starlight to read.\n\nAt a high level, the generator script writes out Markdown / MDX (Markdown with\nReact added) files to src/content/docs for Starlight to read. It also generates\nvarious JSON files in generated/ to build the sidebar and other config.\n\n## 🚀 Starlight Project Structure\n\n```\n.\n├── public/\n├── scripts/\n│   ├── generate.ts\n├── src/\n│   ├── assets/\n│   ├── content/\n│   │   ├── docs/\n│   │   └── config.ts\n│   └── env.d.ts\n├── astro.config.mjs\n├── package.json\n└── tsconfig.json\n```\n\nStarlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory. Each file is exposed as a route based on its file name.\n\nImages can be added to `src/assets/` and embedded in Markdown with a relative link.\n\nStatic assets, like favicons, can be placed in the `public/` directory.\n\n## 🧞 Commands\n\nAll commands are run from the root of the project, from a terminal:\n\n| Command                   | Action                                           |\n| :------------------------ | :----------------------------------------------- |\n| `npm install`             | Installs dependencies                            |\n| `npm run dev`             | Starts local dev server at `localhost:4321`      |\n| `npm run build`           | Build your production site to `./dist/`          |\n| `npm run preview`         | Preview your build locally, before deploying     |\n| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |\n| `npm run astro -- --help` | Get help using the Astro CLI                     |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faep-dev%2Fsite-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faep-dev%2Fsite-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faep-dev%2Fsite-generator/lists"}