TenantAtlas/specs/400-tenantial-homepage-visual-rebuild/quickstart.md
ahmido be314c577f Spec 400: rebuild Tenantial homepage visuals (#387)
## Summary
- rebuild the public Tenantial homepage around an evidence-first Microsoft tenant governance narrative
- replace the old hero visual with a new static dashboard preview and add dedicated Trust Bar and Feature Pillars sections
- update the shared public shell, navigation, footer, dark design tokens, assets, and homepage content to match the new brand direction
- align website smoke coverage and Spec 400 artifacts with the rebuilt homepage

## Testing
- not run in this pass
- updated website smoke specs under apps/website/tests/smoke

## Note
- `website-dev` was pushed to `origin` so the requested PR base exists remotely
- the remote `website-dev` branch is an ancestor of `origin/dev`, so this PR may also show upstream `dev` history relative to that base

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #387
2026-05-18 14:38:11 +00:00

74 lines
2.6 KiB
Markdown

# Quickstart: Tenantial Homepage Visual Rebuild
## Prerequisites
- Work from `/Users/ahmeddarrazi/Documents/projects/wt-website`.
- Use Node.js 20+ with Corepack and pnpm, matching the repo root `packageManager`.
- This feature does not require Sail, Laravel, Filament, a database, Microsoft Graph credentials, or platform auth.
## Install Dependencies
```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 `http://127.0.0.1:4321/`.
## Build Validation
```bash
cd /Users/ahmeddarrazi/Documents/projects/wt-website
corepack pnpm build:website
```
Expected result: Astro builds the static website without requiring platform services.
## Browser Smoke Validation
```bash
cd /Users/ahmeddarrazi/Documents/projects/wt-website
WEBSITE_PORT=4321 corepack pnpm --filter @tenantatlas/website test:smoke
```
Expected proof:
- `/` renders the Tenantial homepage.
- The headline "Evidence-first governance for Microsoft tenants." is visible.
- `Book a demo` and `Explore the platform` are visible with the correct hierarchy.
- Static dashboard preview content is visible.
- Backup, Restore, Drift Detection, Evidence, Audit Trail, and Governance Reviews are visible.
- Old/template public copy is absent from visible homepage content and metadata.
- Existing public pages reachable from the global shell use Tenantial visible brand copy and SEO metadata.
- Mobile viewport has no body-level horizontal overflow.
## Manual Review
Use desktop and mobile browser review after implementation.
Review points:
- Tenantial is the only public brand visible on the homepage.
- No AstroDeck, Open Source, MIT Licensed, TenantCTRL, TenantPilot, or TenantAtlas homepage residue remains.
- No unverified customer logos, certification claims, uptime claims, or fake social proof appear.
- Dashboard preview labels use static/sample/demo wording and do not show future-dated timestamps.
- Header labels and CTA destinations are intentional.
- Dashboard preview is static and does not imply live/realtime data.
- Text does not clip, overlap, or create mobile body overflow.
- Focus states are visible and mobile navigation is keyboard usable.
## Out Of Scope For This Feature
- Do not add demo-booking backend behavior.
- Do not add sign-in/auth behavior.
- Do not add platform API calls.
- Do not add Laravel, Filament, Livewire, Microsoft Graph, database, queue, or OperationRun behavior.
- Do not rename root packages or existing workspace scripts.