TenantAtlas/specs/403-public-website-launch-readiness/quickstart.md
ahmido b9c128163b feat: public website launch readiness updates (#394)
## Summary
- apply public website launch readiness updates across the Astro site shell, content, and navigation
- refine website components, metadata, and localization-related structure for launch prep
- update docs/content paths and smoke coverage to match the launch-ready public site state

## Scope
- touches the website app and related spec artifacts for feature 403
- does not modify `apps/platform`

## Testing
- not run in this step

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #394
2026-05-21 21:41:33 +00:00

120 lines
3.0 KiB
Markdown

# Quickstart: Spec 403 Public Website Launch Readiness
## Scope
Work only in:
```bash
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website
/Users/ahmeddarrazi/Documents/projects/wt-website/specs/403-public-website-launch-readiness
```
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
```
## 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:
- homepage explains Tenantial within the first viewport
- `/platform` explains the public product model, not the internal Laravel/Filament app
- all CTAs resolve to intentional routes or anchors
- no `href="#"` placeholders are visible or emitted
- contact form and footer copy do not imply backend submission or newsletter subscription workflows that do not exist
- `/imprint` contains no production replacement placeholder
- pricing remains contact/demo oriented
- trust and legal pages avoid unsupported certification, endorsement, uptime, recovery, compliance, or customer adoption claims
- static product previews are framed as illustrative/static/demo content
- keyboard users can reach navigation, CTAs, footer links, and visible controls
- visible focus states are present
- no body-level horizontal overflow occurs
- reduced-motion mode leaves content understandable
## Sitemap And Robots Review
After build, inspect:
```text
/robots.txt
/sitemap-index.xml
/sitemap-0.xml
```
Confirm:
- `robots.txt` points to `/sitemap-index.xml`
- canonical rendered routes are included
- redirect-only aliases are excluded
- metadata is Tenantial-specific and route-appropriate
- Open Graph/Twitter URLs and social image metadata are route-appropriate and point to existing assets
## Launch Readiness Handoff
Implementation must add or update a launch-readiness note documenting:
- route exposure
- CTA assumptions
- trust/pricing claim posture
- sitemap behavior
- deployment expectations
- `apps/platform` untouched confirmation