--- name: bolder-developers description: "Read the Bolder Developers docs instead of answering from memory. Developer docs for Bolder: storefronts (JS SDK, components, Liquid themes, CLI) and the REST API. Use when a task involves Bolder Developers: how it works, how to set it up or configure it, or its API." --- # Bolder Developers Developer docs for Bolder: storefronts (JS SDK, components, Liquid themes, CLI) and the REST API. This skill points you at the Bolder Developers docs, at https://developers.onbolder.com/. When a task involves Bolder Developers, read the relevant page before relying on what you remember: the docs are the source of truth, and they change. ## Reading the docs - Any page as Markdown: add `.md` to its URL (the home page is https://developers.onbolder.com/index.md). Every page link below already points at the Markdown. - [llms.txt](https://developers.onbolder.com/llms.txt): every page with a one-line summary. - [llms-full.txt](https://developers.onbolder.com/llms-full.txt): every page in one file, for when you need all of it. - [JSON API](https://developers.onbolder.com/api/docs/pages.json): the page index, with each page as JSON and Markdown. ## API reference - [UCP](https://developers.onbolder.com/frontend/sdk/ucp), with a page per operation (add `.md` for its Markdown). - [API v1](https://developers.onbolder.com/api/v1), with a page per operation (add `.md` for its Markdown). - [API v2](https://developers.onbolder.com/api/v2), with a page per operation (add `.md` for its Markdown). ## Pages ### API - [Bolder API](https://developers.onbolder.com/api.md): Bolder API documentation — v1 and v2. ### CLI - [Getting Started](https://developers.onbolder.com/cli.md): Install the Bolder CLI, log in, and scaffold a storefront project or manage a hosted theme from the terminal. - [Command Reference](https://developers.onbolder.com/cli/reference.md): Every Bolder CLI command — auth, shops, products, orders, webhooks, theme verbs, console and run. - [Theme Workflow](https://developers.onbolder.com/cli/guides.md): Create a hosted project, work against a dev theme locally, and publish changes to the live theme. ### Frontend - [Frontend](https://developers.onbolder.com/frontend.md): The JS SDK for headless integrations, the component library used by hosted themes, and the Liquid reference for building themes. #### SDK - [Overview](https://developers.onbolder.com/frontend/sdk.md): Embed cart and other storefront functionality into any page — a custom HTML site, an SPA, a landing page — without building a full Liquid theme. - [Core API](https://developers.onbolder.com/frontend/sdk/core.md): createStorefront(options), the Emitter, mount(), and the full config reference. - [Cart](https://developers.onbolder.com/frontend/sdk/cart.md): Adding and updating line items, and how cart identity survives cross-origin, cookie-blocked headless integrations. - [Catalog & Search](https://developers.onbolder.com/frontend/sdk/catalog.md): Listing and looking up products, and live typeahead search over WebSocket. - [Forms & Content](https://developers.onbolder.com/frontend/sdk/forms.md): Submitting to a shop's contact forms, and reading the small set of content pages headless shops can still show. - [Authentication & Delivery](https://developers.onbolder.com/frontend/sdk/auth.md): Customer login/registration, the login modal helper, and the delivery-setup overlay. - [Customer Console](https://developers.onbolder.com/frontend/sdk/console.md): The account area (orders, addresses, subscriptions, wishlist) as a separate, tree-shakeable entry point. - [Checkout](https://developers.onbolder.com/frontend/sdk/checkout.md): Embedded (slide-out iframe) vs hosted-redirect checkout, return detection, and the shopping beacon. - [Components (headless import path)](https://developers.onbolder.com/frontend/sdk/components.md): Mounting bolder-storefront's bundled component factories and on-demand components from headless code. - [Core Library](https://developers.onbolder.com/frontend/sdk/library.md): Reference for bolder-storefront's core modules — the loader, request client, and each engine wrapped by createStorefront(). #### Components - [Components](https://developers.onbolder.com/frontend/components.md): JS modules and Custom Element/Vue components used by hosted Bolder themes — bundled (base) or loaded on demand. - [JS Modules](https://developers.onbolder.com/frontend/components/modules.md): Self-contained feature scripts activated via the data-module attribute or imported directly. - [JS Components](https://developers.onbolder.com/frontend/components/components.md): Custom Elements and Vue components, bundled or loaded on demand. #### Themes - [Liquid Reference](https://developers.onbolder.com/frontend/themes.md): Liquid drops, filters, and tags for building hosted Bolder themes. - [Drops](https://developers.onbolder.com/frontend/themes/drops.md): Ruby objects exposed to Liquid templates, with their Liquid-accessible attributes and methods. - [Filters](https://developers.onbolder.com/frontend/themes/filters.md): Custom filters extending Liquid's built-in set. - [Tags](https://developers.onbolder.com/frontend/themes/tags.md): Custom Liquid block/inline tags. ### Guides - [Overview](https://developers.onbolder.com/guides.md): Task-oriented guides for building on Bolder with the REST API, the Storefront SDK, the CLI and AI agents. - [Make your first API request](https://developers.onbolder.com/guides/first-api-request.md): Create a personal access token and call the Bolder v2 API with curl or bolder-api-client. - [Create an order and take payment](https://developers.onbolder.com/guides/create-an-order.md): Create an order from your server with the v2 API, make retries safe with external_id, and send the buyer to checkout. - [Add a cart and checkout to your site](https://developers.onbolder.com/guides/add-a-cart.md): Load the Storefront SDK in any page, add products to the shop's cart and send the customer to checkout. - [Use Bolder checkout with your own cart](https://developers.onbolder.com/guides/checkout-only.md): Keep your own cart and backend, create the order through the API and use only Bolder's checkout, embedded or as a redirect. - [Receive order webhooks](https://developers.onbolder.com/guides/receive-webhooks.md): Subscribe a URL to order events, answer the activation ping, protect the endpoint with basic auth and handle deliveries and failures. - [Build an app for other merchants](https://developers.onbolder.com/guides/build-an-app.md): Register an OAuth application, ask merchants for scoped access with the authorization code flow, and keep tokens fresh. - [Give your AI agent the Bolder docs](https://developers.onbolder.com/guides/ai-agents.md): Point a coding agent at the Bolder docs with llms.txt, Markdown pages and the docs skill, and connect a store to an agent through the MCP server. ### Skills - [Skills](https://developers.onbolder.com/skills.md): Agent skills for working with Bolder from AI tools. Coming soon, and what you can use today.