# Developer Portal (Astro/Starlight)

## Module
DevPortal

## Status
VERIFIED

## Description
Static developer portal built with Astro/Starlight, including API reference pages, try-it console assets, docs guides, and offline bundle packaging suitable for offline/air-gapped delivery.

## Implementation Details
- **Astro/Starlight Site**: `src/DevPortal/StellaOps.DevPortal.Site/`
- **Content Configuration**: `src/DevPortal/StellaOps.DevPortal.Site/src/content/config.ts`
- **API Reference Page**: `src/DevPortal/StellaOps.DevPortal.Site/src/content/docs/api-reference.mdx`
- **Getting Started Guide**: `src/DevPortal/StellaOps.DevPortal.Site/src/content/docs/guides/getting-started.mdx`
- **Navigation Search Guide**: `src/DevPortal/StellaOps.DevPortal.Site/src/content/docs/guides/navigation-search.mdx`
- **OpenAPI Spec**: `src/DevPortal/StellaOps.DevPortal.Site/public/api/stella.yaml`
- **Try-It Console Assets**:
  - `src/DevPortal/StellaOps.DevPortal.Site/public/js/try-it-console.js`
  - `src/DevPortal/StellaOps.DevPortal.Site/public/js/rapidoc-loader.js`
  - `src/DevPortal/StellaOps.DevPortal.Site/public/js/api-reference.js`
- **Build/Validation Scripts**:
  - `src/DevPortal/StellaOps.DevPortal.Site/scripts/build-offline.mjs`
  - `src/DevPortal/StellaOps.DevPortal.Site/scripts/check-links.mjs`
  - `src/DevPortal/StellaOps.DevPortal.Site/scripts/check-perf.mjs`
  - `src/DevPortal/StellaOps.DevPortal.Site/scripts/run-a11y.mjs`
  - `src/DevPortal/StellaOps.DevPortal.Site/scripts/sync-spec.mjs`
- **Integrity Check**: `src/DevPortal/StellaOps.DevPortal.Site/SHA256SUMS.devportal-stubs`

## E2E Test Plan
- [x] Build site and verify static output generation
- [x] Build offline bundle and verify archive output generation
- [x] Run link checker and verify no broken links
- [x] Run accessibility script (with deterministic skip behavior on unsupported host deps)
- [x] Run distribution budget check
- [x] Verify SHA256SUMS entry matches referenced artifact

## Verification
- **Verified**: 2026-02-11
- **Method**: Tier 0 source verification + Tier 1 build + Tier 2 integration/CLI script replay
- **Tier 0 Evidence**: `docs/qa/feature-checks/runs/devportal/developer-portal/run-001/tier0-source-check.json`
- **Tier 1 Evidence**: `docs/qa/feature-checks/runs/devportal/developer-portal/run-001/tier1-build-check.json`
- **Tier 2 Evidence**: `docs/qa/feature-checks/runs/devportal/developer-portal/run-001/tier2-integration-check.json`
- **Tests/Checks**:
  - `npm install`
  - `npm run sync:spec`
  - `npm run build`
  - `npm run build:offline`
  - `npm run lint:links`
  - `npm run test:a11y`
  - `npm run budget:dist`
  - SHA256 verification against `SHA256SUMS.devportal-stubs`

## Notes
- DevPortal scripts were patched for cross-platform reliability:
  - Windows-safe npm invocation in build/preview scripts.
  - Safe process cleanup when `pkill` is unavailable.
  - Correct ESM path resolution in perf checks.
  - Link checker fallback for hosts serving directory pages via `/index.html`.
  - Offline tar packaging fallback when host tar lacks GNU deterministic flags.