Some checks failed
Main Confidence / confidence (push) Failing after 43s
## Summary - implement the website-only core IA for Spec 215 with canonical Home, Product, Trust, Changelog, Contact, Privacy, and Imprint routes - reduce primary navigation to the core buyer journey, retain legal/supporting pages as secondary surfaces, and redirect `/security-trust` to `/trust` - add route metadata, sitemap/canonical handling, changelog publishing, and updated smoke coverage for the new IA contract ## Testing - `corepack pnpm build:website` - `cd apps/website && corepack pnpm exec playwright test` - integrated browser smoke validation for core routes, secondary routes, `/security-trust -> /trust`, hidden optional routes, mobile nav, and Trust/Changelog to Contact paths ## Notes - keeps all changes local to `apps/website` and the Spec 215 artifacts - preserves the website working contract with no `apps/platform` runtime coupling Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #252
3.6 KiB
3.6 KiB
Quickstart: Website Information Architecture / Core Pages
Purpose
This quickstart describes the local workflow for implementing the Spec 215 public-route and navigation contract in apps/website.
Prerequisites
- Node 20+ available through the repo workspace tooling
- Corepack-enabled pnpm
- Repo root at
wt-website
Local Development
Start the website from the repo root:
corepack pnpm dev:website
The website must continue to honor the existing WEBSITE_PORT contract.
Expected Implementation Order
Implement the feature in this order:
- Audit the current public-route truth in
apps/website/src/lib/site.ts,apps/website/src/types/site.ts,apps/website/src/content/pages, andapps/website/src/pages. - Update the route and navigation contract so the canonical core is
/,/product,/trust,/changelog,/contact,/privacy, and/imprint. - Add the missing core pages (
/changelog,/imprint) and replace/security-trustas the canonical trust route with/trust. - Shrink header and footer navigation to the Spec 215 core, keeping only one primary conversion route, gating optional
Resourceslinks on actual content readiness, and leaving thearticlescollection unpublished. - Rationalize current non-core routes such as
/solutions,/integrations,/legal, and/termsas retained secondary surfaces without giving them core-route prominence. - Update sitemap, canonical route generation, and smoke tests to reflect the new IA contract.
- Re-run build and smoke validation.
Working Constraints
The implementation must preserve all existing website working-contract guarantees:
- keep
@tenantatlas/websiteunchanged - keep
WEBSITE_PORTunchanged - keep root
dev:websiteandbuild:websiteworkflows working - keep all IA changes local to
apps/website - do not introduce platform runtime coupling, shared auth, or shared DTO/API assumptions
- do not publish placeholder top-level routes
- keep Trust visible in primary navigation
- keep
/contactas the one clear primary conversion path in the header
Required Validation
Run the website build proof from the repo root:
corepack pnpm build:website
Run the browser smoke suite from the website app:
cd apps/website
corepack pnpm exec playwright test
If an Astro dev server is already running on WEBSITE_PORT, stop it before rerunning Playwright so the suite exercises a fresh server state.
What Reviewers Should Verify
Reviewers should confirm that:
- the canonical core routes load correctly:
/,/product,/trust,/changelog,/contact,/privacy,/imprint - the brand still routes to
/ - Trust is visible in top-level navigation
- Product, Trust, Changelog, and Contact are easier to discover than any optional or deferred surfaces
/resourcesstays hidden unless substantive content exists, and thearticlescollection remains unpublished- any retained compatibility paths are explicit and do not create duplicate canonical truth
- sitemap and canonical links reflect the canonical route set
- no
apps/platformcoupling is introduced
Validation Status
- 2026-04-19:
corepack pnpm build:websitepassed. - 2026-04-19:
cd apps/website && corepack pnpm exec playwright testpassed with 13 smoke tests.
Out of Scope for This Feature
- Hero or section composition
- Final production copy for the individual pages
- Resources activation or later editorial/blog implementation unless actual content is added as part of the same delivery
- Pricing, Docs, Customers, Compare, Careers, or Status surfaces
- Any
apps/platformrouting, theming, or auth behavior