A static documentation site for the OSCAL (Open Security Controls Assessment Language) data models, generated directly from the official NIST OSCAL Metaschema sources.
- Fetches the OSCAL Metaschema XML for every released OSCAL version at build time.
- Parses assemblies, fields, flags, and constraints, including inline
define-assembly/define-fielddefinitions. - Renders a browsable reference for each model (catalog, profile, component-definition, SSP, AP, AR, POA&M) in both JSON and XML form.
- Provides a collapsible top-level format outline plus per-definition cards with linked properties, attributes, constraints, and remarks.
- Astro v6 (static SSG,
output: 'static') fast-xml-parserwith a custom DOCTYPE entity resolver- Modular CSS under
src/styles/(tokens, base, layout, sidebar, cards, definitions, outline) - Deployed via GitHub Actions (
withastro/action) to GitHub Pages
Requires Node.js ≥ 22.12.
npm install
npm run dev # http://localhost:4321/OSCAL-Info/
npm run build # static output in ./dist
npm run previewThe build fetches metaschema sources from GitHub, so an internet connection is required.
Pushes to main trigger the GitHub Actions workflow in .github/workflows/, which builds the
site and publishes dist/ to GitHub Pages.