{"id":43239868,"url":"https://github.com/sysadmindoc/sysadmindoc.github.io","last_synced_at":"2026-04-26T05:01:14.556Z","repository":{"id":339878767,"uuid":"1045385539","full_name":"SysAdminDoc/sysadmindoc.github.io","owner":"SysAdminDoc","description":"Personal portfolio and project showcase site hosted on GitHub Pages.","archived":false,"fork":false,"pushed_at":"2026-04-13T16:59:40.000Z","size":59839,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-13T17:44:10.123Z","etag":null,"topics":["github-pages","html","portfolio"],"latest_commit_sha":null,"homepage":"https://sysadmindoc.github.io/","language":"HTML","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/SysAdminDoc.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"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":"2025-08-27T04:50:26.000Z","updated_at":"2026-04-13T16:59:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/SysAdminDoc/sysadmindoc.github.io","commit_stats":null,"previous_names":["sysadmindoc/sysadmindoc.github.io"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/SysAdminDoc/sysadmindoc.github.io","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SysAdminDoc%2Fsysadmindoc.github.io","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SysAdminDoc%2Fsysadmindoc.github.io/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SysAdminDoc%2Fsysadmindoc.github.io/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SysAdminDoc%2Fsysadmindoc.github.io/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SysAdminDoc","download_url":"https://codeload.github.com/SysAdminDoc/sysadmindoc.github.io/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SysAdminDoc%2Fsysadmindoc.github.io/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32286271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T18:29:39.964Z","status":"online","status_checked_at":"2026-04-26T02:00:05.962Z","response_time":129,"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":["github-pages","html","portfolio"],"created_at":"2026-02-01T11:19:54.836Z","updated_at":"2026-04-26T05:01:14.547Z","avatar_url":"https://github.com/SysAdminDoc.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sysadmindoc.github.io\n\n[![Version](https://img.shields.io/badge/version-0.13.0-blue)](CHANGELOG.md)\n[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)\n[![Platform](https://img.shields.io/badge/platform-GitHub%20Pages-black)](https://sysadmindoc.github.io)\n[![Built with Astro](https://img.shields.io/badge/built%20with-Astro%205-ff5d01)](https://astro.build)\n\nPersonal portfolio and project showcase at [sysadmindoc.github.io](https://sysadmindoc.github.io).\n\n## Stack\n\n- **Astro 5** — static site generator with focused client-side enhancements for the homepage experience\n- **TypeScript** data layer ([src/data/projects.ts](src/data/projects.ts))\n- **Content collections**: featured (9), live apps (22), catalog (138), skills (8)\n- **Build-time GitHub API** — stars, repo metadata, release summaries, and cached READMEs\n- **GitHub Pages + GH Actions** — scheduled data refresh, type checking, build, and deploy\n\n## Develop\n\n```bash\nnpm install\nnpm run fetch-stars   # optional: refresh star cache from GitHub\nnpm run check         # Astro + TypeScript validation\nnpm run dev           # http://localhost:4321\nnpm run build         # output to dist/\nnpm run preview       # serve dist/\n```\n\n`npm run fetch-stars` works best with `GITHUB_TOKEN` set; without it, local runs preserve the existing README cache instead of exhausting the anonymous GitHub rate limit.\n\n## Edit content\n\nAll project entries live in **[src/data/projects.ts](src/data/projects.ts)**. Add an entry → `npm run build` → deploy. No hardcoded HTML.\n\n- Featured: show on the bento grid at the top\n- Live Apps: for GitHub Pages demos\n- Catalog: full searchable repo list (categories: `ps|py|web|ext|kt|sec|media|cs|guide`)\n- Skills: animated ring charts in the Stack section\n\nCategory filter counts auto-compute from the catalog array.\n\n## Deploy\n\nPushes to `main` trigger [.github/workflows/deploy.yml](.github/workflows/deploy.yml) which:\n1. Refreshes generated GitHub data\n2. Runs `npm run check`\n3. Builds the Astro site\n4. Publishes to GitHub Pages\n\nA cron also runs daily to keep the generated GitHub data fresh without needing a push.\n\n## Layout\n\n```\nsrc/\n├── components/      # cards, tag cloud, dividers, greatest-hits modules\n├── data/\n│   ├── types.ts     # TypeScript schemas\n│   ├── projects.ts  # all content (EDIT THIS)\n│   └── _*.json      # generated GitHub cache files (gitignored)\n├── layouts/Base.astro\n├── pages/\n│   ├── index.astro\n│   ├── now.astro\n│   ├── releases.astro\n│   ├── rss.xml.ts\n│   ├── lang/[slug].astro\n│   ├── og/[slug].png.ts\n│   └── projects/[slug].astro\n└── styles/global.css\npublic/\n├── manifest.json\n├── robots.txt\n├── sw.js\n├── screenshots/      # captured live-app thumbnails\n└── scripts/          # theme.js, main.js, cmdk.js\nscripts/\n├── fetch-stars.mjs        # GitHub data refresh (build-time)\n├── capture-screenshots.mjs\n└── generate-data.mjs      # one-off migration helper\nlegacy.html           # backup of pre-Astro single-file site\n```\n\n## Roadmap\n\nSee [ROADMAP.md](ROADMAP.md) for planned work — Tier A/B/C ideas, tech debt, and already-shipped releases.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsysadmindoc%2Fsysadmindoc.github.io","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsysadmindoc%2Fsysadmindoc.github.io","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsysadmindoc%2Fsysadmindoc.github.io/lists"}