Skip to content

Add Astro website with searchable catalog and compatible data exports - #528

Open
MHaggis wants to merge 3 commits into
LOLBAS-Project:masterfrom
MHaggis:MHaggis/lolbas-astro-site-build
Open

MHaggis wants to merge 3 commits into
LOLBAS-Project:masterfrom
MHaggis:MHaggis/lolbas-astro-site-build

Conversation

@MHaggis

@MHaggis MHaggis commented Oct 7, 2026 •

Copy link
Copy Markdown

LOLBAS currently publishes through Jekyll. This adds a static Astro site built directly from the existing YAML catalog, with instant search, combined filters, sortable columns, recently added ordering, catalog growth charts, and full command/detail pages.

Existing detail URLs and category anchors, JSON fields, CSV columns, Navigator data, and the count badge remain compatible. No source catalog records are changed. The original project title and existing LOLBAS badge favicon are retained. About lists maintainers first with their published X handles; primary button text stays readable before hover. New valid entries populate the site and exports automatically on each build.

  • Cached CI validates YAML/schema, formatting, Astro types, data/API contracts, production output, and Chromium interactions; successful fork builds provide downloadable review artifacts.
  • Official publication stays disabled until maintainers deliberately enable the cutover. The existing publisher remains in place, with cutover and rollback steps documented in website/README.md.
  • The clickable review demo is published by a separate workflow on the fork's default branch. That workflow is not included in this PR and cannot publish the official site.

Review demo: https://mhaggis.github.io/LOLBAS/

Fork CI: https://github.com/MHaggis/LOLBAS/actions/runs/37814050408

Fork preview build/deployment: https://github.com/MHaggis/LOLBAS/actions/runs/37814280916

Upstream PR CI: https://github.com/LOLBAS-Project/LOLBAS/actions/runs/37814060271

Local validation: 16 data/release tests, 10 Chromium tests, the project-path preview smoke test, Astro check, verified build (251 pages / 245 catalog routes), canonical YAML/schema validation, formatting, actionlint, and independent API/publication/preview review. Fork CI, fork preview deployment, and upstream PR checks all passed. The hosted homepage, search-to-detail navigation, source revision, and API exports were verified; hosted JSON/CSV hashes match the local build. Official deployment was skipped as intended.

Homepage

LOLBAS homepage

Searchable catalog

Searchable and sortable catalog

Detail pages

LOLBAS command detail page

About and maintainers

LOLBAS maintainers with X links

Mobile

Mobile LOLBAS layout

@MHaggis
MHaggis requested a review from a team as a code owner October 7, 2026 16:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant