# ViVA — Everyday marketplace

Version 1.1.0 · 2026-10-25 · WOG Labs

A forest-green marketplace with a lifestyle hero, nine categories, product deals, promotional tiles and a complete store footer.

## Quick start
1. Extract the entire ZIP, keeping index.html and assets/ together.
2. Open index.html in a modern browser. No build, package manager or network service is needed.
3. Edit the HTML, CSS tokens and JavaScript catalog in any text editor. Replace the sample copy and reference imagery with approved content.
4. Optional: give the source and PROMPT.md to a coding assistant, or use SKILL.md in the assistant’s supported workflow.
5. Check the main interactions, keyboard access and 375/768/1024/1440px layouts before publishing on a static host.

## Included sections
- Shipping announcement, searchable header and shop navigation
- Lifestyle merchandise hero with collection controls
- Nine category choices and five product-deal cards
- Three promotional collections and a customer-story carousel
- Newsletter form, service assurances and a five-column footer

## Working interactions
- Search the sample catalog and filter by category, including empty/reset states.
- Add products, change quantities, remove items and see the calculated subtotal.
- Open the sample wishlist and add a saved product to the bag.
- Switch the featured headline and rotate the sample reviews.
- Validate an email in the newsletter preview without sending or saving it.

## Files
- index.html — actual responsive preview source, with embedded CSS and JavaScript.
- assets/ — local WebP imagery, font files and font licenses. Keep these relative paths intact.
- PROMPT.md / SKILL.md — customization brief and reusable workflow.
- README.md / ASSETS.md — usage, provenance and limitations.
- LICENSE / PHOSPHOR-LICENSE.txt — implementation and icon notices.

## Demo boundaries
This is a front-end reference reconstruction. All changes last only until reload. There is no account, checkout, payment, email delivery, order tracking, analytics, database or backend. Forms validate locally and report that no submission was sent or saved. Sample reviews, ratings, customer counts, people, prices and offers are reference content, not verified claims. Color selection demonstrates a selected state and does not recolor a product photograph.

The page uses the reference’s light theme. The WOG Labs detail page separately follows the site’s theme setting. Desktop geometry follows a 1440px presentation of the supplied screenshot; layouts below 700px adapt to a phone.

## Rights
Implementation and instructions: MIT. Supplied photographs and brand artwork: rights not independently verified, not included in the MIT grant. Replace them with approved assets before commercial publishing. Fonts: SIL OFL 1.1. Icons: Phosphor MIT. Read ASSETS.md and retain all notices.

## Release notes
1.0.0 — Initial reference-inspired implementation, responsive interactions, preview, source assets, prompt, skill and rights documentation.
