# FORME — The Website Collection

Seven polished, editable business website templates plus a connected commerce admin inside a complete design showroom. Plain HTML, CSS, and JavaScript, local photography, and no runtime dependencies or installation step.

## Open the collection

Open `index.html` in a modern browser, or start the optional local server from this folder:

```sh
node server.mjs
```

Visit **http://localhost:4173**. Stop with Ctrl+C. Set `PORT` to change the port. The server listens only on this computer. It is a development convenience, not a production backend.

Python alternative:

```sh
python -m http.server 4173 --bind 127.0.0.1
```

npm is optional. If available, `npm start` starts the same server and `npm run check` checks JavaScript syntax. Direct file opening supports the brochure designs, previews, and guided brief without a network connection. Use the local server for reliable sharing between the commerce storefront and admin. Clipboard access can be unavailable on a file URL; the brief download remains available.

## The collection

| Folder | Brand | Design direction |
| --- | --- | --- |
| `creative-studio/` | Form / Field | Ivory, black, electric blue, original SVG brand concepts |
| `nordic-construction/` | Nordhavn | Beige, navy, architecture and warm serif headings |
| `luxury-detailing/` | Apex Atelier | Dark cinematic imagery, precise detailing and pale green accents |
| `restaurant/` | Ember | Terracotta, cream, expressive serifs and arched photography |
| `interior-design/` | Still | Sage, organic neutrals, split layouts and thoughtful spacing |
| `fitness/` | Pulse | Charcoal, lilac, bold type and energetic training formats |
| `online-store/index.html` | OBJECT Store | Editorial commerce, warm neutrals, product browsing and shopping bag |
| `online-store/admin.html` | OBJECT Admin | Products, image management, categories, inventory, orders and settings |

All businesses, services, prices, and portfolio entries are illustrative. No testimonials, trading history, booking availability, or performance statistics are claimed.

## What's new in version 3

- A complete OBJECT online store with eight original product illustrations, category browsing, search/sorting, product galleries, shopping bag, and simulated checkout.
- A connected admin with a dashboard, product editor, real local image uploads, cover/reorder controls, categories, bulk moves/status updates, stock filters, orders, and store settings.
- Browser-local persistence with live updates between store and admin tabs, catalogue export/import, and reset.
- Two new commerce experiences in the main showroom and the project assistant.
- See [COMMERCE.md](COMMERCE.md) for setup, walkthrough, limits, and integration notes.

### Existing collection features

- A complete branded showroom with editorial art direction and six distinct previews.
- Industry filters, text search, live result counts, and an empty-search reset.
- Interactive website previews with desktop and mobile viewport modes, scrolling, full-site links, and a design-to-enquiry handoff.
- A seven-step project assistant shared across the collection and standalone templates.
- Email follow-up or callback preferences, review/back navigation, design recommendations, and copy/download of the resulting brief.
- A restaurant menu with keyboard-accessible Dinner, Lunch, and Drinks tabs.
- Refined hover, focus, and finishing details on the first three designs.

## The easier contact flow

Click **Start a project**, **Help me choose**, or the floating assistant button. Customers can describe their business, goal, design preference, scope, budget, timing, and preferred reply method one small step at a time. They do not have to open an email client or create an account.

The assistant is a transparent **guided conversation**, not an AI model. It runs entirely in the browser and uses simple industry matching for its design suggestion.

**Delivery is intentionally not connected yet.** The current preview creates a brief the visitor can copy or download; it does not send anything. `assets/config.js` exposes the future same-origin delivery endpoint and optional business WhatsApp number. See [CONTACT-SETUP.md](CONTACT-SETUP.md) for the endpoint contract, integration instructions, and differences between the sales assistant and each business template's demo form.

No API keys belong in the public configuration. Connecting a real endpoint requires your own backend or form-service adapter. No inbox, CRM, AI service, or production booking platform is provisioned.

## Customise the showroom

- **Brand:** edit the wordmark, page title, metadata, copy, FAQ, and footer in `index.html`.
- **Designs:** each `.design-card` contains its category, name, URL, description, visual preview, and tags. Keep `data-url` pointing to its real template. Add or adjust the filter buttons when adding categories.
- **Visual style:** `assets/showroom.css` controls the collection. Thumbnail art uses lightweight HTML/CSS; opening Live preview loads the actual website in an iframe.
- **Preview sizes:** `assets/showroom.js` uses 1440px for desktop and 390px for mobile. It scales the desktop viewport to fit the preview panel while preserving its actual layout.
- **Contact:** `assets/concierge.js` holds the prompts, suggested answers, design matching, validation, review, and handoff behaviour. Edit the text and options to match your real offering. Style the assistant in `assets/concierge.css`.

## Customise an individual template

Each template's `index.html` contains its navigation, copy, services, projects, approach, and demonstration contact form.

- Replace brand names, page titles, metadata, placeholder contact details, fictional prices, and sample projects with your own authorised content.
- Edit colours through `--paper`, `--ink`, `--accent`, `--muted`, and `--line`. The first three themes are in `assets/style.css`; the new three are in `assets/new-themes.css`.
- System Arial/Helvetica and Georgia avoid external font downloads. If adding your own licensed fonts, self-host WOFF2 and use `font-display: swap`.
- Replace the local JPEGs with your own licensed images, keeping meaningful alt text and accurate width/height attributes. The studio concept illustrations are editable inline SVGs.
- Project buttons use `data-title` and `data-description` for the detail dialog. Update these along with each visible heading and category.
- Keep service-prefill `data-service` values aligned with contact form option text.
- The sales assistant on a template lets showroom visitors enquire about a website like that design. For a client handover, remove or adapt it to the client's own customer needs.

The business designs share assets. The commerce store and admin share a separate browser-local model; see `COMMERCE.md` before extracting them. To extract one as its own website, copy its HTML and the `assets/` folder, change `../assets/` paths to `assets/`, replace the “Explore all designs” link, and remove unnecessary themes/images. The first three templates use `refinements.css`; the new three use `new-themes.css`.

## Interaction and accessibility

- Responsive navigation, semantic landmarks, visible keyboard focus, skip links, and labelled fields.
- Native project and enquiry dialogs with Escape handling and focus containment.
- Restaurant tabs support Left/Right Arrow, Home, and End, with proper tab/panel relationships.
- Reduced-motion support, deferred scripts, lazy below-fold imagery, and no autoplay video.
- Preview iframes hide their sales assistant; the outer showroom manages the enquiry handoff.
- With JavaScript disabled, normal template content remains visible and mobile navigation is exposed. Showroom arrow links open the complete websites. Interactive preview, filtering, guided enquiry, and demo submission require JavaScript.
- No trackers, cookies, external webfonts, or third-party runtime requests by default.

## Verification performed

The commerce extension passed 21 isolated model checks and browser checks for product creation/editing, real local image upload, image cover changes, category renaming and bulk moves, publication synchronisation, shopping bag quantities, checkout, stock reduction, cancellation/restocking, catalogue export/import, store settings, inventory filters, and mobile fit. Its sample data was restored after testing. See `COMMERCE.md` for the exact scope.


Browser checks covered the showroom and all six templates at desktop (1440px) and phone (390px) viewports, with no horizontal page overflow detected. Image assets loaded. Filters, empty searches, desktop/mobile previews, design handoff, mobile navigation, restaurant tabs including keyboard arrows, and complete enquiry flows for both email and callback preferences were exercised. A text brief download was confirmed. A narrow-screen panel sizing issue was fixed and rechecked.

JavaScript syntax and local HTML links/assets/unique IDs were also checked. No Lighthouse score, exhaustive accessibility audit, or real enquiry delivery test is claimed. Delivery and WhatsApp remain unconfigured. Test them with your actual destination before launch.

## Performance

The project has no framework or package dependencies. Six local JPEGs total about 1.63 MB across the entire collection; shared caching and lazy loading avoid fetching every image on each page. The homepage's first view uses one main photograph plus CSS artwork. Each template only loads the shared files it needs. Hero imagery is prioritised, and explicit image dimensions help prevent layout shifts.

## Publish

Upload the HTML pages and `assets/` to a static host, preserving relative paths. No build is needed. `server.mjs` and `package.json` are unnecessary on a static host. If you connect `/api/enquiries`, deploy that separately using the same website origin.

The collection can be shared as a public static preview. Store/admin edits remain local to each visitor’s browser. Replace fictional content, configure delivery, and add actual business/privacy information before accepting real enquiries. Run `node build-static.mjs` to prepare the publishable files in `dist/`; local server code and tests are excluded.

## File map

```text
index.html                       FORME showroom
creative-studio/index.html        Form / Field
nordic-construction/index.html    Nordhavn
luxury-detailing/index.html       Apex Atelier
restaurant/index.html            Ember
interior-design/index.html       Still
fitness/index.html               Pulse
online-store/index.html          OBJECT storefront
online-store/admin.html          OBJECT admin
assets/commerce-core.js          Shared browser-local commerce model
assets/storefront.js             Store browsing, bag, and demo checkout
assets/storefront.css            Commerce storefront design
assets/admin.js                  Product, category, image, order, and settings controls
assets/admin.css                 Responsive admin design
assets/products/*.svg            Original product artwork
tests/commerce.test.mjs          Repeatable commerce model checks
COMMERCE.md                      Commerce setup and walkthrough
assets/style.css                 Shared components and first three themes
assets/refinements.css           Finishing details for the first three themes
assets/new-themes.css             Ember, Still, and Pulse
assets/main.js                   Template menus, dialogs, demo forms, service prefilling
assets/template-extras.js        Restaurant tabs and embedded-preview adjustments
assets/showroom.css              Collection design and preview UI
assets/showroom.js               Filters, search, and preview controls
assets/concierge.css             Shared project assistant UI
assets/concierge.js              Guided brief, validation, review, copy/download, delivery
assets/config.js                 Public delivery and WhatsApp configuration
assets/*.jpg                     Six local photographs
assets/favicon.svg               Editable SVG favicon
server.mjs                       Optional local development server
package.json                     Optional convenience scripts
CONTACT-SETUP.md                 Real enquiry integration guide
ASSETS.md                        Photograph provenance
README.md                        This guide
```

Original template code and original CSS/SVG artwork may be edited and reused in your own projects. Photographs remain subject to their source licence; see `ASSETS.md`. Fictional names are examples, not trademark clearance.
