Consumer-local route · src/pages-local/features.astro
Feature matrix
Everything portfolio-engine ships today, in one table. The "Theme routes" and "Named override surfaces" rows read their counts at build time from DEFAULT_ROUTE_REGISTRY and DEFAULT_OVERRIDE_SURFACES exported from @portfolio-engine/editorial-theme, so this page cannot drift from the theme's public surface.
| Feature | Status | What it does |
|---|---|---|
| Theme routes | shipped | Routes injected by editorialTheme() — home, about, work (+detail), writing (+detail), contact, résumé. |
| Consumer-local routes | shipped | Add pages the theme doesn't know about via src/pages-local/ + portfolio-engine.registry.json. Collision-checked against theme routes. |
| Named override surfaces | shipped | Typed prop contracts for each override surface. Trying to override anything else is a build-time error. |
| Style overrides | shipped | CSS files passed to overrides.styles are appended after global.css so consumer styles always win. |
| Design tokens (theme.json) | shipped | Semantic colors and typography in one JSON file. Resolved into CSS custom properties; Google Fonts wired automatically. |
| IframeEmbed | shipped | Security-vetted iframe wrapper: HTTPS-only or same-origin paths, optional host allowlist, typed sandbox / allow / referrerpolicy. |
| SchedulingBlock | shipped | Provider-light scheduling component (Calendly, Cal, Google Calendar, Microsoft Bookings, custom) with button / link / embed modes. |
| Admin tools | optional | /admin dashboard + GitHub OAuth + Contents-API writes. Or devBypass: true for local-only direct-to-disk writes. |
| Setup-with-Claude flow | shipped | Paste docs/downstream/setup-with-claude.md into Claude Code. Numbered phase scripts with DRY_RUN and SKIP_* flags. |
| One-click upgrade | shipped | VS Code task + shell script that pins every @portfolio-engine/* package to @latest in lockstep. |
| Manifest + doctor CLI | shipped | .portfolio-engine/manifest.json emitted every build. pnpm pe:doctor inspects route origins, override status, and theme version. |
| workflow-kit | experimental | Scaffold and guardrail templates. GitHub Actions CI, pre-commit hooks, content boundary checks, schema strictness checks, and agent prompt files. |
Live registry data
What the theme actually declares
DEFAULT_ROUTE_REGISTRY
- / public
- /about public
- /work public
- /work/[slug] hidden
- /writing public
- /writing/[slug] hidden
- /contact public
- /resume public
DEFAULT_OVERRIDE_SURFACES
- Hero (person, bookingUrl, pillars, base, tagline, ctas)
- FeaturedWriting (posts, base)
- TestimonialSection (testimonials)
- CollaborationSection (base, ctaBody)
- Footer (adminHref, siteTitle, adminLinkLabel)