# Quickstart: Spec 404 Public Content Architecture & Messaging

## Scope

Work only in:

```bash
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website
/Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging
```

Do not touch:

```bash
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/platform
```

## Install Dependencies If Needed

```bash
cd /Users/ahmeddarrazi/Documents/projects/wt-website && corepack pnpm install
```

## Run The Website Locally

```bash
cd /Users/ahmeddarrazi/Documents/projects/wt-website && WEBSITE_PORT=4321 corepack pnpm dev:website
```

Open:

```text
http://127.0.0.1:4321
```

## Read-Only Content Audit

Review public content sources before editing:

```bash
cd /Users/ahmeddarrazi/Documents/projects/wt-website
rg -n "Tenantial|TenantAtlas|TenantPilot|TenantCTRL|ScrewFast|construction|hardware|manufacturing|trusted by|SOC 2|ISO|uptime|checkout|subscribe|sign up|login" apps/website/src
```

Audit these content surfaces:

- `/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/index.astro`
- `/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/platform.astro`
- `/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/pricing.astro`
- `/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/trust.astro`
- `/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/contact.astro`
- `/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs`
- `/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files`
- `/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/utils/navigation.ts`
- `/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/Meta.astro`

## Content Review Checklist

For the homepage:

- hero identifies Tenantial as evidence-first governance for Microsoft tenant configuration
- first two sections mention at least three of backup, restore, drift, findings, evidence, audit trail, exceptions, and reviews
- headings read as a coherent story from product category to evaluation
- each section adds new meaning
- CTAs match buyer stage and route intentionally

For `/platform`:

- explains backup, restore, drift, findings, evidence, auditability, exceptions, and reviews as one model
- stays public and does not cite `apps/platform`
- frames previews as static/demo/illustrative where needed
- does not imply live Microsoft tenant connection or Graph execution

For pricing/evaluation:

- contact-led and scoped
- no checkout, subscription activation, self-serve billing, account creation, or unsupported entitlement claims
- CTAs resolve to `/contact` or another intentional target

For trust/FAQ/footer/legal-adjacent content:

- no unsupported SOC 2, ISO, Microsoft endorsement, uptime, recovery, compliance, or customer-proof claims
- no fake customer logos, testimonials, or "trusted by" claims
- no public website live-tenant-data implication
- no newsletter, login, scheduling, or backend submission implication unless implemented

## Build Validation

```bash
cd /Users/ahmeddarrazi/Documents/projects/wt-website && corepack pnpm build:website
```

## Smoke Validation

```bash
cd /Users/ahmeddarrazi/Documents/projects/wt-website && WEBSITE_PORT=4321 corepack pnpm --filter @tenantatlas/website test:smoke
```

## Static Git Validation

```bash
cd /Users/ahmeddarrazi/Documents/projects/wt-website && git diff --check
cd /Users/ahmeddarrazi/Documents/projects/wt-website && git status --short -- apps/platform
```

The `apps/platform` command must print no output.

## Manual Browser Review

Review these routes in desktop and mobile widths, light and dark modes:

- `/`
- `/platform`
- `/pricing`
- `/contact`
- `/trust`
- `/legal`
- `/privacy`
- `/terms`
- `/imprint`
- `/welcome-to-docs/`
- `/guides/intro/`
- `/guides/getting-started/`
- `/guides/first-project-checklist/`
- `/platform/evidence-review/`

Check:

- product category is clear from the homepage hero and first sections
- homepage headings form a coherent narrative
- `/platform` explains the product model more deeply than the homepage
- pricing remains conservative and contact-led
- trust copy avoids unsupported proof
- CTAs are consistent and targets are intentional
- no `href="#"` placeholders are visible or emitted
- no forbidden public residue terms appear in visible copy or metadata
- static product previews are framed as illustrative/static/demo content where needed
- keyboard users can reach navigation, CTAs, footer links, FAQ controls, and visible controls
- visible focus states are present
- no body-level horizontal overflow occurs
- reduced-motion mode leaves content understandable

## Handoff

Implementation summary must document:

- changed public pages and docs surfaces
- CTA language decisions
- claim-safety decisions
- metadata changes
- validation results
- remaining content follow-ups
- `apps/platform` untouched confirmation