// Run npm run build on jetson-ai-lab and triage Astro content collection / MDX / model frontmatter / benchmarks.json failures after edits. Use when verifying the site builds after content, model, tutorial, benchmark, or asset changes.
| name | jetson-ai-lab-verify-build |
| description | Run npm run build on jetson-ai-lab and triage Astro content collection / MDX / model frontmatter / benchmarks.json failures after edits. Use when verifying the site builds after content, model, tutorial, benchmark, or asset changes. |
| license | Apache-2.0 |
| compatibility | Requires Node.js and npm. Run from the repository root where package.json lives. |
Run a full static build after any change to:
src/content/models/*.md (model catalog frontmatter / Run / Serve / one-shot)src/content/tutorials/**/*.{md,mdx}src/content/projects/**, src/content/gtc26/**, or any other src/content/ collectionsrc/data/benchmarks.json (the model-page benchmark chart joins on this)public/ (including public/code-samples/)When writing or editing tutorials, include authors in frontmatter.
From the repository root (where package.json and astro.config.mjs live):
npm run build
Resolve all errors before merging. The dev server alone is not enough for content-schema issues — the production build is what runs Zod validation across all collections.
superRefine)If you see an error path on supported_inference_engines or a message like:
Provide supported_inference_engines and/or serving.entries (non-empty), one_shot_inference commands, or set hide_run_button: true.
Fix the offending file in src/content/models/ per skill jetson-model-catalog-inference: provide either serving.entries, supported_inference_engines, a meaningful one_shot_inference, or set hide_run_button: true.
Other typical model-page schema failures:
Invalid url on huggingface_url / build_nvidia_url → must be a full https://... URL, not a slug.Required on title, short_description, or precision → these three are the only top-level required fields.modalities / matrix_modules_disabled / benchmark_series → these must be arrays of strings, not comma-separated text.benchmark_key mismatch (silent)The model page joins to src/data/benchmarks.json by benchmark_key === models[].name. A typo does not fail the build — the benchmark chart simply does not render. After adding benchmark_key, open /models/<slug> locally and confirm the chart appears.
Likewise benchmark_series entries silently drop unmatched names.
src/data/benchmarks.json uses different ids from the matrix module list. Valid benchmark product ids are:
t5000, t4000, agx_orin_64gb, orin_nx_16gb, orin_nano_8gb, dgx_spark
If you accidentally use matrix ids (orin_agx_64, orin_nano_8, etc.) inside concurrency1 / concurrency8 / oom / dnr, the build still passes (JSON is not Zod-validated), but the bars / OOM markers don't render. See the matrix-id ↔ product-id table in skill jetson-model-catalog-inference.
Tutorial files under src/content/tutorials/ are MDX. Common parse failures:
$ or {} inside HTML tags mixed with Markdown can break the MDX parser. Keep shell variables inside fenced code blocks when possible, or use HTML entities.< characters in inline prose are interpreted as JSX tag opens.Broken links to /code-samples/... usually mean the file is missing under public/code-samples/ — see skill jetson-ai-lab-code-samples.
| Item | Path |
|---|---|
| Build script | package.json (scripts.build) |
| Astro config | astro.config.mjs |
| Model validation | src/content/config.ts (models collection superRefine) |
| Benchmark data file | src/data/benchmarks.json |
| Model catalog skill | .agents/skills/jetson-model-catalog-inference/SKILL.md |
| Code samples skill | .agents/skills/jetson-ai-lab-code-samples/SKILL.md |
Configure Jetson AI Lab model pages — frontmatter for the Model Details sidebar (parameters, modalities, context length, license, precision pills), the Run on Jetson serve/call/one-shot UI, the three "block" levers (hide_run_button, matrix_modules_disabled, per-engine modules_supported), and the join to src/data/benchmarks.json (benchmark_key, benchmark_series, OOM vs DNR vs null). Use when adding or editing model pages, inference engines, serve/run commands, one-shot blocks, the details sidebar, benchmark wiring, or deciding whether to mark a Jetson module as OOM, blocked, or simply untested.
Place downloadable tutorial scripts under public/code-samples/ and link them from tutorial pages. Use when adding, moving, or linking downloadable scripts, assets, or code files for Jetson AI Lab tutorials.