SDKs
SDKs overview
Official Feeef clients for JavaScript/TypeScript and Dart/Flutter.
Both SDKs are first-party — the JavaScript SDK powers the storefront and admin dashboard, and the Dart SDK powers the official merchant app. They track the API closely and share the same repository-per-resource design, so knowledge transfers between them.
JavaScript / TypeScript
npm feeef — typed repositories, cart service, realtime SSE, OAuth helpers.
Dart / Flutter
pub feeef — the singleton client behind the merchant app, with auth persistence and realtime.
Shared design
| Concept | JavaScript | Dart |
|---|---|---|
| Entry point | new FeeeF({ apiKey, baseURL }) | Feeef.instance.init(baseUrl: …, storage: …) |
| HTTP | Axios (bring your own instance) | Dio (owned by the singleton) |
| Resources | feeef.products, feeef.orders, … | Feeef.instance.products, .orders, … |
| Lists | ListResponse { data, total, page, limit } | ListResponse<T> (same normalization) |
| Filtering | filterator param on list() | filterator param on list() |
| Batch ops | batchCreate/batchUpdate/batchDelete mixins | Same, via repository batch mixins |
| Realtime | createFeeefTransmit + RealtimeCrudEvent | Feeef.instance.realtime (transmit_client) |
| Uploads | feeef.storage.upload(file) | Feeef.instance.storage.upload(file: …) |
| OAuth | feeef.oauth.* + buildAuthorizeUrl | Feeef.instance.oauth.* + AppRepository.buildAuthorizeUrl |
Which one?
- Building for the web (Node, Next.js, storefront themes, dashboards, bots) → JavaScript.
- Building mobile or desktop apps with Flutter → Dart.
- Building a server integration in another language → call the REST API directly;
the OpenAPI spec at
api.feeef.org/openapi.jsoncan generate a client.