Troubleshooting
Use this page when the docs or platform-adjacent development workflow stops at a known failure mode.
Content schema errors
Section titled “Content schema errors”Every Markdown or MDX page in src/content/docs/guides/ needs valid frontmatter. At minimum, include:
---title: Page Title---Ignored dependency builds
Section titled “Ignored dependency builds”If pnpm reports ignored build scripts for frontend dependencies, review the approved build settings before rebuilding native packages. Do not remove dependency lockfiles or rewrite unrelated install state.
Missing routes
Section titled “Missing routes”If a sidebar or header link 404s, confirm the page exists under src/content/docs/guides/ and that its generated route matches the configured /guides/... link.
Local server checks
Section titled “Local server checks”Use 127.0.0.1 if localhost resolves differently on a machine. The standard local checks are:
http://127.0.0.1:3000http://127.0.0.1:8000/system/health