> For the complete documentation index, see [llms.txt](https://docs.lufavo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lufavo.com/roomfolk/pages/home-page.md).

# Home page

The home page is built entirely from sections, so you arrange it however suits your shop.

## What it comes with

Roomfolk installs with a home page already laid out:

| Section                                                          | What it does                              |
| ---------------------------------------------------------------- | ----------------------------------------- |
| [Hero](/roomfolk/sections/hero.md)                               | Headline, buttons and a background image. |
| [Feature strip](/roomfolk/sections/feature-strip.md)             | Delivery, returns and guarantee promises. |
| [Collection list](/roomfolk/sections/collection-list.md)         | Shop by room or category.                 |
| [Featured collection](/roomfolk/sections/featured-collection.md) | A row of products.                        |
| [How it works](/roomfolk/sections/how-it-works.md)               | Your process, in steps.                   |
| [Testimonials](/roomfolk/sections/testimonials.md)               | Customer quotes.                          |
| [Blog posts](/roomfolk/sections/blog-posts.md)                   | Recent posts.                             |
| [Email signup](/roomfolk/sections/email-signup.md)               | Newsletter signup.                        |
| [FAQ](/roomfolk/sections/faq.md)                                 | Common questions.                         |

Use it as a starting point. Remove what you do not need, reorder the rest, and add sections with **Add section**.

## What to fill in first

Four things need content from you before the page looks finished:

1. **Hero** — your headline and a background image.
2. **Collection list** — a collection for each card.
3. **Featured collection** — the collection to show.
4. **Testimonials** — your own customer quotes.

Until you do, those sections draw placeholders. That is intentional — the theme cannot bring another store's photographs or collections with it — but it does mean a freshly installed home page looks unfinished until you have been through it.

## Ordering the page

A rough shape that works for most shops:

* Something that says what you sell, immediately — the hero.
* A reason to trust you — the feature strip.
* A way in to the range — collection list or featured collection.
* Something that answers a hesitation — how it works, testimonials, FAQ.
* Something to do if they are not buying today — the newsletter.

You do not have to follow it. But avoid stacking three product rows together, or putting the newsletter above the products.

## Hiding a section

You do not have to delete a section to remove it from the page. The eye icon in the theme editor hides it, keeping its settings for later.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.lufavo.com/roomfolk/pages/home-page.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.