> ## Documentation Index
> Fetch the complete documentation index at: https://86d.store/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Store locator

> Physical store locations with proximity search for 86d. Map view powered by Google Maps when GOOGLE_MAPS_API_KEY is set.

<Warning>
  **Experimental.** This Module has no test or production evidence recorded yet. Read it, run it locally, and hold off on real Orders. See [maturity levels](/docs/resources/versioning).
</Warning>

The Store Locator [Module](/docs/concepts/modules) keeps a directory of your physical store locations. Each location has an address, hours, contact details, and optional services such as BOPIS and in-store returns. When `GOOGLE_MAPS_API_KEY` is set, the [Storefront](/docs/concepts/storefront) component renders an interactive map and a proximity-sorted list; without the key, it falls back to a list-only view.

**Source:** [`modules/store-locator`](https://github.com/86d-store/86d/tree/main/modules/store-locator) · **npm:** [`@86d-store/store-locator`](https://www.npmjs.com/package/@86d-store/store-locator)

## Installation

```sh theme={null}
86d module add store-locator
```

## Store endpoints

| Method | Path                          | Description        |
| ------ | ----------------------------- | ------------------ |
| `GET`  | `/locations`                  | List all locations |
| `GET`  | `/locations/near?postalCode=` | Sorted by distance |

## Admin endpoints

| Method   | Path                   | Description |
| -------- | ---------------------- | ----------- |
| `POST`   | `/admin/locations`     | Create      |
| `PUT`    | `/admin/locations/:id` | Update      |
| `DELETE` | `/admin/locations/:id` | Delete      |

## Components

* `<StoreLocator />`: the full map and list view.
* `<NearestStore />`: a compact widget for the homepage.

## Related pages

* [Store pickup](/docs/modules/store-pickup)
* [Returns](/docs/modules/returns)
* [Storefront](/docs/concepts/storefront)
* [Glossary](/docs/resources/glossary)
* [Versioning and maturity](/docs/resources/versioning)