# Overview

<!-- prettier-ignore-start -->

# What this theme gives you

Concierge turns a service website into a calm first conversation. Visitors answer one useful question at a time, keep a visible summary of their choices, and finish at the right booking, enquiry, or contact route.

## How to use it

1. Activate **Concierge** from Capell's theme-management surface.
2. Choose **Practice Calm**, **Private Office**, or **Night Triage** in Theme Studio, then adjust the normal theme controls.
3. Add a Conversation Stage and its supporting Concierge sections in Layout Builder.
4. Start from the veterinary, home-services, or clinic recipe, then edit its questions, choices, outcomes, and handoff details.
5. Test every terminal path, urgent escape route, and fallback before publishing.

## Concierge sections

- **Conversation stage** asks one question at a time in default, split, or embedded form.
- **Path breadcrumbs** and the **summary dossier** let visitors review and change earlier answers.
- **Triage outcomes**, **urgent route**, **proof**, and **team matches** keep guidance and reassurance close to the decision.
- **Intake handoff** passes declared hidden values into Form Builder, prefers Bookings for routine appointments, and retains a safe email fallback.
- **Question directory** exposes every valid path as ordinary links for visitors who prefer an index.

## Recipes

- **Veterinary practice** includes new-patient, routine, and urgent paths with dog- and cat-specific vaccination questions.
- **Home services** routes job type, property, timing, and access details.
- **Clinic intake** collects appointment purpose, symptoms, timing, and preferred handoff.

Clone a recipe before making substantial changes. Keep choice keys short and stable because they form the public `?path=` URL. Changing a key changes that public URL.

## Search and caching

- The opening question, terminal outcomes, and the question directory are indexable.
- Intermediate question states use `noindex,follow`.
- Invalid paths redirect with HTTP 302 to the deepest valid prefix.
- Non-terminal states can be cached by site, locale, and the allow-listed `path` parameter.
- Terminal handoff states are marked non-cacheable because they can render request-specific form state.

## Good to know

- JavaScript improves same-page navigation, focus, history, and the dossier. Every choice remains a normal link and the full journey works without it.
- Bookings, Form Builder, Blog, Search, Countdown, and Location Map are optional. Missing packages fall back to ordinary links, static changeover copy, directions, or email.
- Countdown copy is only enhanced after the client can verify a valid changeover time; the server-rendered urgent telephone route always remains available.
- Fernbrook Veterinary Practice, its people, address, telephone number, email, testimonials, and clinical copy are fictional. Replace all of them before publishing.
- Concierge guides visitors but does not diagnose conditions or replace professional or emergency advice.

---

For developers: see the [README](../README.md).

<!-- prettier-ignore-end -->