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

2.6 KiB

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

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

Run The Website Locally

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

Open http://127.0.0.1:4321/.

Build Validation

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

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.