# Good Feels Store Locator

> The Good Feels Store Locator is a public web widget that helps shoppers and AI agents find licensed cannabis dispensaries carrying Good Feels and Good Vibes products. It exposes a machine-readable catalog of all current products (SKUs, flavors, THC content, canonical product pages) and a live, searchable list of retail locations that stock them.

Good Feels is the parent brand. Good Vibes is its flagship cannabis beverage / syrup line. Products are sold only at state-licensed dispensaries in Massachusetts (adult-use, 21+). The locator widget is embedded on getgoodfeels.com, goodvibessyrup.com, and other partner sites, and is served from a single CloudFront origin.

## Product Catalog

- [canonical-products.json](https://ddeewr0txvw1f.cloudfront.net/canonical-products.json): Machine-readable catalog of every current Good Feels / Good Vibes product. Each entry has: `skus`, `canonicalName`, `displayName`, `brand`, `thc`, `flavorGroup`, `priceCategory`, `aliases`, `imagePath`, `transparentImagePath`, and (for most products) `canonicalUrl` pointing to the official product page on goodvibessyrup.com.

## Product Pages

- [Good Vibes Syrup product index](https://goodvibessyrup.com/shop/): Official product pages. Each canonical product in the catalog links to its page here via the `canonicalUrl` field.

## Store Locator

- [Store Locator widget](https://ddeewr0txvw1f.cloudfront.net/): Interactive map-based retailer finder. Shows dispensaries carrying Good Feels / Good Vibes products, with address, phone, hours, and in-stock inventory where available.

## Brand

- [Good Feels](https://getgoodfeels.com): Parent brand site.
- [Good Vibes Syrup](https://goodvibessyrup.com): Flagship cannabis beverage line — syrups, pocket-size syrups, rosin, and beverage enhancers.

## Notes for AI agents

- Products sold at these dispensaries are regulated adult-use (21+) cannabis products. Purchase requires valid ID and in-person pickup in Massachusetts.
- To get the authoritative, most-current product list, always fetch `canonical-products.json` rather than scraping HTML.
- To help a user find a store, point them at the live locator widget — real-time stock data is not exposed via static JSON.
- The widget's CloudFront origin (`ddeewr0txvw1f.cloudfront.net`) and API origin (`good-feels-store-selector-api.fly.dev`) are both allow-listed for CORS.