# feeef developer platform feeef is a commerce platform for merchants. Its developer platform provides a REST API, OAuth apps, JavaScript and Dart SDKs, a storefront template compiler and CLI, signed webhooks, and a hosted MCP server for AI agents. Storefront templates are authored in TSX and compiled into TemplateData JSON. The CLI can preview a draft against a hosted store's real catalog before publishing and installing a release. OAuth lets merchants grant applications access; the API enforces token permissions and store roles. The operations APIs cover inventory stock and movements, supplier bills and payments, and parcels with carrier accounts, quotes, and labels. Store permissions and enabled integration requirements apply. ## Start building - [Developer platform](https://feeef.dev/): The platform overview and developer entry points. - [Quickstart](https://feeef.dev/docs/quickstart): Make an authenticated API call and register an app. - [REST API](https://feeef.dev/docs/api): Resources, pagination, filtering, batch operations, and errors. - [Apps and OAuth](https://feeef.dev/docs/oauth): Authorization code with PKCE and scoped access. - [JavaScript SDK](https://feeef.dev/docs/sdks/javascript): The official feeef npm package. - [Dart SDK](https://feeef.dev/docs/sdks/dart): The official client used by the merchant application. - [Create a storefront template](https://feeef.dev/docs/templates/create): TSX source, editor schemas, JSON output, and hosted draft preview. - [CLI](https://feeef.dev/docs/cli): Sign in, scaffold, build, preview, and publish templates. - [Webhooks](https://feeef.dev/docs/webhooks): HMAC-signed order and product events with delivery history. - [Inventory](https://feeef.dev/docs/api/inventory): Stock objects, reservations, and movement records. - [Finance](https://feeef.dev/docs/api/finance): Supplier bills, payments, and financial accounts. - [Shipping](https://feeef.dev/docs/api/shipping): Parcel records, carrier accounts, quotes, and labels. - [Connect an AI agent](https://feeef.dev/docs/mcp/connect): Connect an MCP client with OAuth or a bearer token. - [Shipping](https://feeef.dev/docs/api/shipping): Cloud parcels, carrier accounts, fees, labels, and tracking. - [Finance](https://feeef.dev/docs/api/finance): Wallets, courier cash-in, payouts, procurement, and reports. - [Inventory](https://feeef.dev/docs/api/inventory): Cloud stock engine, reservations, and movements. - [Places](https://feeef.dev/docs/api/geo): Commune search, wilayas, and stop desks. - [Geo playground](https://feeef.dev/playground): Sign in with Feeef and call the places API. - [Engineering blog](https://feeef.dev/blog): Inventory, finance, shipping, and storefront notes. - [Brand resources](https://feeef.dev/brand): Official lowercase name, logos, colors, and usage guidelines. ## Common questions ### What is feeef? feeef is a commerce platform for merchants. Its developer platform provides a REST API, OAuth apps, JavaScript and Dart SDKs, storefront templates, a CLI, webhooks, and an MCP server. Developers can work with stores, products, orders, delivery integrations, inventory, and finance. ### How are feeef storefront templates built? A feeef template is authored as a Node.js package with TSX components, an editor schema, and locale files. The template kit compiles these sources into a JSON document called TemplateData, which the Lithium storefront renderer reads. Developers define editable props and slots; merchants customize their content. The CLI previews a draft on a hosted store before a release is published and installed. ### Can AI agents connect to feeef? Yes. The hosted feeef MCP server at https://mcp.feeef.org/mcp uses Streamable HTTP and supports OAuth or a bearer token. Compatible clients can use its tools to work with stores, products, orders, delivery, inventory, and finance. API token permissions, store roles, and integration requirements still apply. # Documentation - [Feeef Developer Platform](/docs): The map of everything you can build on Feeef — API, OAuth apps, SDKs, CLI, templates and webhooks. - [Changelog](/docs/changelog): What changed on the Feeef developer platform — storefront runtimes, CLI, API and shipping. - [Quickstart](/docs/quickstart): From zero to your first authenticated API call and registered app. - [Authentication](/docs/authentication): How Feeef tokens, abilities and sign-in methods work across the platform. - REST API - [API conventions](/docs/api): Hosts, pagination, the filterator query language, batch operations, errors and realtime. - [Stores](/docs/api/stores): Store CRUD, slug/domain lookup, members & RBAC scopes, invites, custom domains, template preview and analytics surfaces. - [Products](/docs/api/products): Product CRUD with variants, offers and addons, category tree operations, and per-product analytics. - [Orders](/docs/api/orders): Order lifecycle, guest checkout, totals calculation, public tracking, batch updates, the confirmation queue and dispatching. - [Payments & wallet](/docs/api/payments): Order checkout (methods, session, status, refunds) and wallet deposits via Stripe, PayPal, Chargily, SATIM and in-app purchase. - [Integrations](/docs/api/integrations): Per-store integration configs, the config envelope, and paid integration subscriptions with wallet billing. - [Delivery](/docs/api/delivery): Legacy per-carrier integrations. New shipping uses the Cloud parcel API. - [Shipping](/docs/api/shipping): The Cloud parcel API — carrier accounts, fees, quotes, parcels, labels, tracking, and sending an order. - [Connectors](/docs/api/connectors): Inbound product/order import connectors — Shopify, YouCan, Google Sheets, Facebook Lead Ads — connect, pull, and webhook sync. - [Marketing](/docs/api/marketing): Meta (Facebook) Marketing integration — OAuth connect, ad accounts, campaign/adset/ad reads, ad↔product links — and Meta/TikTok pixel server events. - [Finance](/docs/api/finance): Wallets, courier cash-in, payouts, procurement, bills, receivables, and cash-basis reports. - [Inventory](/docs/api/inventory): Stock objects, availability, movements, reservations, warehouses and SKU aliases — the project-scoped stock engine behind orders. - [Places](/docs/api/geo): Cloud geo — commune search, wilayas, stop desks, courier coverage, and resolving a free-text address. - [Storage](/docs/api/storage): Image and video uploads plus the per-user file browser — list, upload, move, delete and inspect files on the storage CDN. - [AI](/docs/api/ai): Every Feeef AI feature under /v1/ai — text, code, HTML landing pages, images, image landing pages, voice and studios. All of it runs on Feeef Cloud. - [Analytics](/docs/api/analytics): Store summaries, lite orders reports (LOR) for sparklines, and order/financial timelines. - [Reference data](/docs/api/reference-data): Geo data (countries, states, cities), currencies, and the public platform config. - API Reference: Generated endpoint reference - [API reference](/docs/api/reference): Generated from the backend OpenAPI spec — every endpoint, grouped by resource, with an interactive playground and curl/JavaScript/Dart/Python samples. - [Actions](/docs/api/reference/actions) - [Aliases](/docs/api/reference/aliases) - [Analytics](/docs/api/reference/analytics) - [App User](/docs/api/reference/appuser) - [Auth](/docs/api/reference/auth) - [Availability](/docs/api/reference/availability) - [Brand Studios](/docs/api/reference/brandstudios) - [Categories](/docs/api/reference/categories) - [Chargily](/docs/api/reference/chargily) - [Cities](/docs/api/reference/cities) - [Cloud Ai](/docs/api/reference/cloudai) - [Cloud Geo](/docs/api/reference/cloudgeo) - [Cloud Order Ship](/docs/api/reference/cloudordership) - [Cloud Parcels](/docs/api/reference/cloudparcels) - [Cloud Parcels Webhook](/docs/api/reference/cloudparcelswebhook) - [Cloud Voice](/docs/api/reference/cloudvoice) - [Codpilot](/docs/api/reference/codpilot) - [Configs](/docs/api/reference/configs) - [Connectors](/docs/api/reference/connectors) - [Connectors Facebook Leads](/docs/api/reference/connectorsfacebookleads) - [Connectors Google Sheets](/docs/api/reference/connectorsgooglesheets) - [Connectors Shopify](/docs/api/reference/connectorsshopify) - [Connectors Youcan](/docs/api/reference/connectorsyoucan) - [Countries](/docs/api/reference/countries) - [Currencies](/docs/api/reference/currencies) - [Customer Payments](/docs/api/reference/customerpayments) - [Deposits](/docs/api/reference/deposits) - [Developer OAuth](/docs/api/reference/developeroauth) - [Dispatcher](/docs/api/reference/dispatcher) - [Ecomanager](/docs/api/reference/ecomanager) - [Ecotrack](/docs/api/reference/ecotrack) - [Expense Categories](/docs/api/reference/expensecategories) - [Expenses](/docs/api/reference/expenses) - [Facebook Marketing](/docs/api/reference/facebookmarketing) - [Feedbacks](/docs/api/reference/feedbacks) - [Feeef Delivery](/docs/api/reference/feeefdelivery) - [Finance Charges](/docs/api/reference/financecharges) - [Finance Payments](/docs/api/reference/financepayments) - [Finance Payouts](/docs/api/reference/financepayouts) - [Finance Reports](/docs/api/reference/financereports) - [Finance Transfers](/docs/api/reference/financetransfers) - [Finance Wallets](/docs/api/reference/financewallets) - [Financial Accounts](/docs/api/reference/financialaccounts) - [Google Sheets](/docs/api/reference/googlesheets) - [Image Generations](/docs/api/reference/imagegenerations) - [Image Landing Pages](/docs/api/reference/imagelandingpages) - [Image Prompt Templates](/docs/api/reference/imageprompttemplates) - [In-App Purchase](/docs/api/reference/inapppurchase) - [Integration Subscription](/docs/api/reference/integrationsubscription) - [Maystro Delivery](/docs/api/reference/maystrodelivery) - [MDM Express](/docs/api/reference/mdmexpress) - [Meta Ads](/docs/api/reference/metaads) - [Meta Integration](/docs/api/reference/metaintegration) - [Movements](/docs/api/reference/movements) - [Noest](/docs/api/reference/noest) - [OAuth Apps](/docs/api/reference/oauthapps) - [Objects](/docs/api/reference/objects) - [Operations](/docs/api/reference/operations) - [Order Analytics](/docs/api/reference/orderanalytics) - [OrderDZ](/docs/api/reference/orderdz) - [Order Payment](/docs/api/reference/orderpayment) - [Orders](/docs/api/reference/orders) - [Orders V1](/docs/api/reference/ordersv1) - [Other Income Categories](/docs/api/reference/otherincomecategories) - [Other Incomes](/docs/api/reference/otherincomes) - [Pages](/docs/api/reference/pages) - [Passkey](/docs/api/reference/passkey) - [PayPal](/docs/api/reference/paypal) - [Post Studios](/docs/api/reference/poststudios) - [Procolis](/docs/api/reference/procolis) - [Product Landing Pages](/docs/api/reference/productlandingpages) - [Product Landing Page Templates](/docs/api/reference/productlandingpagetemplates) - [Products](/docs/api/reference/products) - [Projects](/docs/api/reference/projects) - [Promos](/docs/api/reference/promos) - [Purchase Orders](/docs/api/reference/purchaseorders) - [Purchase Receipts](/docs/api/reference/purchasereceipts) - [Reservations](/docs/api/reference/reservations) - [SATIM](/docs/api/reference/satim) - [SATIM Checkout](/docs/api/reference/satimcheckout) - [Shipping Methods](/docs/api/reference/shippingmethods) - [Shipping Prices](/docs/api/reference/shippingprices) - [Slick Pay](/docs/api/reference/slickpay) - [Social Auth](/docs/api/reference/socialauth) - [States](/docs/api/reference/states) - [Store Delivery Bridge](/docs/api/reference/storedeliverybridge) - [Store Integrations](/docs/api/reference/storeintegrations) - [Store Invites](/docs/api/reference/storeinvites) - [Store Insights](/docs/api/reference/stores) - [Store Template Locales](/docs/api/reference/storetemplatelocales) - [Store Template Preview](/docs/api/reference/storetemplatepreview) - [Store Templates](/docs/api/reference/storetemplates) - [Stripe](/docs/api/reference/stripe) - [Subscription](/docs/api/reference/subscription) - [Summaries](/docs/api/reference/summaries) - [Supplier Bills](/docs/api/reference/supplierbills) - [Supplier Payments](/docs/api/reference/supplierpayments) - [Suppliers](/docs/api/reference/suppliers) - [Template Components](/docs/api/reference/templatecomponents) - [Templates](/docs/api/reference/templates) - [Transfers](/docs/api/reference/transfers) - [Ui Studios](/docs/api/reference/uistudios) - [Users](/docs/api/reference/users) - [Stores](/docs/api/reference/userstores) - [Voiceover](/docs/api/reference/voiceover) - [Voice Projects](/docs/api/reference/voiceprojects) - [Warehouses](/docs/api/reference/warehouses) - [Webhooks](/docs/api/reference/webhooks) - [Yalidine](/docs/api/reference/yalidine) - [Zimou](/docs/api/reference/zimou) - [ZR Express](/docs/api/reference/zrexpress) - **Apps & OAuth** - Apps & OAuth - [Apps & OAuth overview](/docs/oauth): Register OAuth clients and let Feeef users grant your integration scoped access. - [Authorization code flow](/docs/oauth/authorization-code): Step-by-step OAuth 2.0 authorization code walkthrough with PKCE, error handling and SDK helpers. - [Scopes reference](/docs/oauth/scopes): Every OAuth scope, the implication hierarchy, and how grants are computed. - [App data buckets](/docs/oauth/app-data): Namespaced JSON storage on apps and per-user pivot rows — public, private and protected tiers. - [Webhooks](/docs/webhooks): HMAC-signed order and product events pushed to your endpoints, with a management API and delivery history. - **SDKs** - SDKs - [SDKs overview](/docs/sdks): Official Feeef clients for JavaScript/TypeScript and Dart/Flutter. - [JavaScript SDK](/docs/sdks/javascript): The feeef npm package — typed repositories over the whole API, cart service, realtime and OAuth helpers. - [Dart SDK](/docs/sdks/dart): The feeef Dart package that powers the official merchant app — repositories, auth persistence, realtime and integrations. - **Tools** - [Feeef CLI](/docs/cli): @feeef.dev/cli — sign in with OAuth, scaffold storefront templates, live-preview drafts on your real store, and publish to the marketplace. - MCP server - [MCP server](/docs/mcp): The hosted Feeef MCP server at mcp.feeef.org — let AI agents manage stores, products, orders, delivery, landing pages and finance over the Model Context Protocol. - [Connect a client](/docs/mcp/connect): Add the Feeef MCP server to Cursor, Claude Code, Claude Desktop or VS Code — with browser OAuth or a bearer-token header. - [Tools reference](/docs/mcp/tools): All 138 tools of the Feeef MCP server, namespace by namespace — plus the tools_search discovery gateway and the server:// resources. - **Storefront** - Storefront templates - [Storefront templates](/docs/templates): Build editable Feeef themes as documents, with Helium runtime guides, draft previews and marketplace releases. - [Helium runtime](/docs/templates/helium): Build a Feeef storefront theme for Hono + Preact, with isolated server rendering and explicit browser islands. - [Hydration in Helium](/docs/templates/helium-hydration): Choose when custom components become interactive, and safely keep static blocks as server HTML. - [Move a theme to Helium](/docs/templates/helium-migration): Review a Lithium theme, port its blocks and routes, and verify a Helium release without replacing the live install during development. - [How the template system works](/docs/templates/concepts): The concept behind Lithium themes — why a storefront is a document, and how schema, data, the editor, and the renderer stay apart. - [Create a template](/docs/templates/create): Create a Helium storefront theme, edit a merchant-controlled block, preview it on your store and publish a release. - [Develop and publish](/docs/templates/develop): The developer loop for a Feeef theme — edit, preview a draft on the real shop, then publish a release and decide when customers see it. - [Data model](/docs/templates/data-model): The TemplateData contract — component nodes, propsSchema, slots vs children, and field ownership. - [Custom components](/docs/templates/components): Author React components for themes — the injected scope API, styling rules, and TypeScript with npm imports. - [Template kit](/docs/templates/kit): Author themes as folders of TSX files and compile them to TemplateData with the Feeef CLI. - [Order form](/docs/templates/order-form): The COD order form contract — composition with slots, field visibility, draft orders, geo, validation, security, and the floating CTA. - [Shared components](/docs/templates/shared-components): Reuse one component across pages — kit-level $ref at build time vs runtime reference nodes from the component library. - [Schema library](/docs/templates/schema-library): The theme's drag-drop catalog — declare optional block presets in library/components/ and merchants add them from the editor. - [Standard pages](/docs/templates/standard-pages): Checkout, thanks, and product pages — the single-main-section contract, slots, and the data each page receives. - [Theming](/docs/templates/theming): Dark, light and system modes on CSS tokens — brand color conversion, the corner radius system, and the design tokens custom components must use. - [Localization](/docs/templates/i18n): Theme translations — locales/*.json in the kit, the store_template_locales storage, and the t() pipeline with fallback rules. - [Product lists](/docs/templates/product-lists): Build PLPs, related-product rails, search grids and carousels with the filterator query language and the products/categories list APIs. - [Marketing pixels](/docs/templates/pixels): How pixel events fire from themes — funnel events in the browser, order conversions from the server, GA4, the FeeefPixels helper, dynamic Lead/Purchase objectives, and testing. - [Performance](/docs/templates/performance): LCP and image rules for themes, the check:perf static scanner, accessibility budgets, and PageSpeed verification. - [Authoring conventions](/docs/templates/conventions): The design-system.md contract, currency symbols, GFM product bodies, the Feeef footer credit, and naming rules every theme must follow. - [AI and templates](/docs/templates/ai): How AI is wired into the template system — component generation, page editing, landing pages, the validation and repair pipeline, and the kit's agent pack. - [Marketplace](/docs/templates/marketplace): Publish templates, cut releases, sell paid listings, and manage licenses, reviews and earnings. # Blog # Docs - [Building Cobalt: from a blank template to a real Feeef storefront](/blog/building-cobalt): My working notes on designing, debugging, testing, and publishing a Feeef template—with a real demo store, screenshots, and a live playground. - [Develop on a draft, publish when you mean it](/blog/develop-on-a-draft): The two commands I actually use. One shows the theme to me. The other is how it reaches a customer, and only when I pass --apply. - [Customers never see your draft](/blog/draft-preview): feeef template dev writes a second document on the store. I lost an hour once because my laptop and the shop were talking to different APIs. - [Introducing the Feeef Template Design System](/blog/feeef-template-design-system): Why themes are documents, how JSON and React meet, and what that means for merchants, developers, and the storefront. - [Eight thousand stores, one process](/blog/helium-performance): How we measured Helium's origin performance, removed repeated render work, and kept the memory story honest. - [Meet Helium, the new home for Feeef themes](/blog/helium-storefront-runtime): A smaller storefront runtime, the same editable theme document, and a clearer boundary between merchant code and the platform. - [How Feeef finance moves money](/blog/how-finance-works): Wallets, courier cash-in, order collection, payouts, and the purchase that becomes both stock and a bill. - [Give every block a browser budget](/blog/hydration-by-intent): Why Helium keeps custom components interactive by default, and how theme authors can remove browser work with confidence. - [The inventory engine: one quantity the order can trust](/blog/inventory-engine): How Feeef stock works now — scoped SKUs, reservations, movements, and why the number on the product is no longer the stock. - [Sending 500 orders](/blog/sending-five-hundred-orders): The courier takes 50 or 100 parcels per call. A desk selection of 500 is one Feeef request, then chunks with a short rest between them. - [Shipping is a parcel now](/blog/shipping-on-the-parcel-api): Carrier accounts, fee cards, quotes, stop desks, labels, and what happens when the commune is not covered. - [Stop shipping one order form](/blog/slots-not-a-funnel): I built a checkout I was proud of, in one file. Merchants could not move a field. That is the whole story. - [A theme is a document, not a deploy](/blog/themes-are-data): I keep explaining this to people who just want a deploy button. A Feeef theme is the JSON the shop already knows how to render. # Brand - [feeef brand assets and guidelines](https://feeef.dev/brand): Official wordmark, f symbol, colors, original design files, and usage guidance. - [Plain Markdown brand guide](https://feeef.dev/brand/guide.md): The complete human-readable guidelines and direct asset downloads. - [Brand asset manifest](https://feeef.dev/brand/assets.json): Download URLs, file formats, dimensions, and asset metadata.