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

85 lines
2.5 KiB
Markdown

# 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:
```bash
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:
```bash
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:
```bash
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:
```bash
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