> For the complete documentation index, see [llms.txt](https://hollow-peak.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hollow-peak.gitbook.io/docs/store/store-setup.md).

# Store Setup

Currency, tax, shipping and the store basics.

**Store → Settings**

## Currency

{% hint style="danger" %}
**Set this before creating any products.**

Prices are stored as integers in the currency's minor units. Changing the currency later does **not** convert them — a product priced 2500 stays 2500, meaning something quite different.

If you must change it, re-price every product deliberately.
{% endhint %}

The currency governs the shop, the cart, the checkout and which payment providers can serve you.

## Store country

Where you trade from. Used for tax defaults and to decide which regional payment providers apply.

## Menu label

What the shop is called in your navigation — “Shop”, “Store”, “Products”.

## Products per page

How many appear before paging. 12 to 24 suits most catalogues.

## Tax

A rate and whether prices include or exclude it.

{% hint style="warning" %}
Hollow Peak applies the rate you configure. It does not determine your obligations, handle multiple jurisdictions, or file anything. Tax is your responsibility — take advice if you sell across borders.
{% endhint %}

## Shipping

A flat rate, and optionally free shipping above a threshold.

Only products marked as requiring shipping contribute. An order of digital goods alone is never charged shipping.

## Moving the shop's address

The shop lives at `/shop` by default. To move it, set `STORE_PREFIX` in `.env`:

```ini
STORE_PREFIX=products
```

Then `php artisan optimize:clear`.

## The shop page

The shop listing is an ordinary **page**, editable in the page builder. Add a hero above the products, an FAQ below, or anything else.

Its address comes from the route rather than its slug, so renaming the page cannot move it somewhere nothing is listening.

If the page is deleted or unpublished, the address still answers with a built-in listing — the shop never disappears.

## Before selling

* [ ] Currency set
* [ ] Country set
* [ ] Tax configured, or deliberately zero
* [ ] Shipping configured, if you ship
* [ ] At least one payment provider tested
* [ ] A complete test order placed
* [ ] Order confirmation email received


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://hollow-peak.gitbook.io/docs/store/store-setup.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
