TenantAtlas/specs/213-website-foundation-v0/quickstart.md
ahmido 2d552c7ae8
Some checks failed
Main Confidence / confidence (push) Failing after 42s
feat: initial website foundation and v0 product site (#249)
## Summary
- establish the initial Astro website foundation for `apps/website` with explicit TypeScript, Tailwind CSS v4, and reusable layout/content primitives
- ship the v0 public route set for home, product, solutions, security & trust, integrations, contact, legal, privacy, and terms
- add SEO/discovery basics, Playwright browser smoke coverage, and the full Spec 213 planning bundle under `specs/213-website-foundation-v0`
- extend ignore rules for website test artifacts and refresh Copilot agent context for the new website stack

## Validation
- `corepack pnpm build:website`
- `cd apps/website && corepack pnpm exec playwright test`

## Notes
- branch: `213-website-foundation-v0`
- commit: `020d416d0d8af4d16a981ff4f4f6d90153b9c603`

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #249
2026-04-18 20:56:47 +00:00

2.5 KiB

Quickstart: Initial Website Foundation & v0 Product Site

Purpose

This quickstart describes the expected local workflow for implementing and validating the v0 TenantAtlas public website inside apps/website.

Prerequisites

  • Node 20+ available via the repo workspace tooling
  • Corepack-enabled pnpm
  • Repo root at wt-website

Local Development

Start the website development server from the repo root:

corepack pnpm dev:website

The website must continue to honor the existing WEBSITE_PORT convention.

Expected Foundation Work

Implement the feature in this order:

  1. Add explicit TypeScript setup inside apps/website.
  2. Add Tailwind CSS v4 using the CSS-first model and migrate styling toward shared tokens and reusable utilities.
  3. Build shared layout, primitive, section, and content helpers.
  4. Assemble the published core routes: Home, Product, Solutions, Security & Trust, Integrations, Contact, Legal, Privacy, Terms.
  5. Add SEO/discovery basics and a lightweight Playwright browser smoke suite.

Build Validation

Run the required website build proof from the repo root:

corepack pnpm build:website

Success means the Astro site builds cleanly without breaking root workspace contracts.

Required Final Validation

Before considering the feature complete, run both proof commands:

corepack pnpm build:website
cd apps/website && corepack pnpm exec playwright test

Browser Smoke Validation

After the Playwright smoke suite is added to apps/website, run:

cd apps/website
corepack pnpm exec playwright test

The smoke suite should remain intentionally small and verify:

  • core public routes load successfully
  • primary and footer navigation have no dead ends
  • core CTAs remain reachable
  • mobile navigation remains usable

Content / Launch Review

Before calling the feature complete, confirm:

  • every public claim is substantiated
  • Product and Solutions stay distinct
  • Security & Trust contains no speculative promises
  • Integrations contains no wishlist-only entries presented as live truth
  • Privacy and Terms are present and linked from footer and contact flow
  • any required jurisdiction-specific public legal notice is present through the Legal hub or a linked dedicated notice page

Out of Scope for This Feature

  • product-app runtime coupling
  • internal CRM / billing / customer portal logic
  • a public docs/blog/changelog launch
  • a required React layer
  • an internal contact submission backend