Project: French clothing brand visual & functional prototype
Stack: HTML5 + Tailwind CSS v4 (CDN) — No React, no JS frameworks
Team: 2 developers (collaborative Git workflow)
/
├── index.html # Home — hero, new arrivals, best sellers, navbar, footer
├── catalog.html # Catalog — filter bar + 4×5 product grid (20 items)
├── product.html # Product view — 2-column layout, add to cart, description
├── cart.html # Cart — 3 sample products, summary box, purchase button
├── checkout.html # Checkout — 3-step form (personal, shipping, payment)
├── server.py # Flask dev server (port 3000)
├── learn.json # Project metadata
├── README.md # Documentation
├── README.cn.md
├── README.es.md
└── PLAN.md # This file
| # | Criterion | Status | Evidence |
|---|---|---|---|
| 1 | 5 HTML files (one per view) | ✅ | index.html, catalog.html, product.html, cart.html, checkout.html |
| 2 | All pages linked via navigation | ✅ | Shared navbar with links to Home, Catalog, Cart; footer links to Catalog |
| 3 | Shared navbar & footer on all pages | ✅ | Identical navbar + footer copied across all 5 files |
| 4 | Tailwind CSS only (no React/JS frameworks) | ✅ | Only Tailwind CDN — no JavaScript frameworks |
| 5 | Fully responsive (mobile, tablet, desktop) | ✅ | grid-cols-1 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4; hamburger menu on mobile |
| 6 | Semantic HTML5 | ✅ | <header>, <nav>, <main>, <section>, <article>, <aside>, <footer> |
| 7 | Schema.org SEO (JSON-LD) | ✅ | Organization on home, BreadcrumbList on catalog, Product+Offer on product |
| 8 | Git collaboration (branches, PRs) | ✅ | Feature branches for each view, PR workflow |
| 9 | French brand aesthetic — elegant design | ✅ | Minimal palette (gray-900, gray-50, white), refined typography, Parisian brand identity |
| 10 | Error-free, functional prototype | ✅ | All 5 pages return HTTP 200 — verified with python3 server.py |
- Tailwind CSS v4 CDN added
- Navbar: Logo, search bar, user account menu, mobile hamburger toggle
- Hero section: Full-width gradient banner with CTA button
- New Arrivals: 4-product responsive grid
- Best Sellers: 4-product responsive grid
- Footer: Categories, Legal, Contact columns
- Schema.org
OrganizationJSON-LD - Mobile menu toggle JavaScript
- Shared navbar & footer from homepage
- Breadcrumb nav (Home › Catalog)
- Filter bar: Category dropdown + Size dropdown
- 20 product cards in 4×5 responsive grid
- Each card links to product.html
- Schema.org
BreadcrumbListJSON-LD
- Shared navbar & footer
- Breadcrumb nav (Home › Catalog › Product)
- Two-column layout (image left 50%, info right 50%)
- Product name, reference code, size selector, price, quantity, Add to Cart button
- Description section: Materials + Recommended use
- Schema.org
Product+OfferJSON-LD
- Shared navbar & footer
- 3 sample products with thumbnail, name, price, qty, total
- Order Summary box: Subtotal, Tax (8.5%), Total
- Purchase button → links to checkout.html
- Responsive layout (1 column on mobile, sidebar on desktop)
- Shared navbar & footer
- Step indicator (1 → 2 → 3)
- Step 1: Personal details (name, email, phone)
- Step 2: Shipping address (street, city, zip, country)
- Step 3: Card payment (cardholder, number, expiry, CVV)
- Total summary + Confirm Purchase button
- All 5 pages return HTTP 200 ✅
- Tailwind CDN in all files (no other CSS/JS frameworks)
- No lint/compile errors
- Responsive grid breakpoints on all pages
- Semantic HTML5 elements throughout
- Schema.org structured data on 3 pages
- Cross-page links: Home ↔ Catalog ↔ Product ↔ Cart ↔ Checkout
- Brand-consistent color palette and typography
pip3 install flask
python3 server.py
# → http://localhost:3000Navigate between pages via the navbar or direct URLs:
http://localhost:3000/— Homehttp://localhost:3000/catalog.html— Cataloghttp://localhost:3000/product.html— Producthttp://localhost:3000/cart.html— Carthttp://localhost:3000/checkout.html— Checkout
main
└── develop
├── feature/homepage → index.html
├── feature/catalog → catalog.html
├── feature/product → product.html
├── feature/cart → cart.html
└── feature/checkout → checkout.html
- Create feature branch from
develop:git checkout -b feature/homepage - Make changes →
git add .→git commit -m "feat: add homepage with hero and product sections" - Push:
git push origin feature/homepage - Open Pull Request → teammate reviews → merge to
develop - Repeat for all features → final merge
develop→main
| Decision | Choice | Reason |
|---|---|---|
| CSS Framework | Tailwind CSS v4 (CDN) | Per project spec — utility-first, responsive, no JS |
| Navbar approach | Static HTML (copied) | Pure HTML only — no server-side includes |
| Product images | Emoji placeholders | Prototype phase — easy to swap for real images later |
| Color palette | Grays, white, beige, navy | French brand elegance — minimal and refined |
| Mobile menu | Simple JS toggle | One function, no external dependencies |
| Schema.org | JSON-LD in <head> |
Best practice for SEO — invisible to layout |
- Replace emoji placeholders with actual product images
- Add a CSS-only carousel for New Arrivals / Best Sellers
- Implement form validation with HTML5 attributes
- Add a confirmation page after checkout submit
- Convert static navbar/footer into a shared partial (if moving to SSR)
- Add more product variants and filtering logic