A comprehensive TypeScript SDK for building Adobe Commerce integrations with Adobe App Builder.
This monorepo contains a collection of modular libraries that streamline the development of Adobe Commerce applications on the App Builder platform. Each package is designed to be used independently or combined through a convenient meta-package.
# Install the complete SDK
pnpm install @adobe/aio-commerce-sdk
# Or install individual packages
pnpm install @adobe/aio-commerce-lib-auth@adobe/aio-commerce-sdk- Unified meta-package providing convenient access to all SDK libraries through a single import@adobe/aio-commerce-lib-auth- Handles authentication flows for Adobe IMS and Adobe Commerce, including token management and credential validation@adobe/aio-commerce-lib-config- Manages hierarchical business configuration with scope inheritance for Adobe Commerce applications@adobe/aio-commerce-lib-core- Provides foundational utilities and shared functionality used across all@adobe/aio-commerce-sdklibraries@adobe/aio-commerce-lib-events- Facilitates event-driven integrations between Adobe Commerce and Adobe I/O Events
Unlike some other languages, JavaScript/TypeScript doesn't have one unified toolchain that does everything. That's why we use many different tools for different purposes.
This project uses the following tools, find a detailed explanation/justification for each in the development guide:
- PNPM - Fast, disk space efficient package manager (replacing
npm) - Turborepo - High-performance build system for monorepos
- TypeScript - For type-safe development.
- TSDown - Modern bundler specialized for TypeScript libraries.
- Vitest - Fast TypeScript-compatible testing framework
- Biome - Fast formatter and linter
We warmly welcome contributions! This project features a comprehensive development guide that covers everything you need to know:
The guide includes detailed information about:
- Project Standards - TypeScript, ESM modules, documentation guidelines
- Development Setup - Prerequisites, installation, editor configuration
- Package Creation - Using generators to scaffold new packages
- Testing - Writing and running tests with Vitest
- Building & Publishing - Configuring builds and preparing releases
- Release Process - Using changesets for version management
See also the Contributing Guide for more information on contributing guidelines.
This project is licensed under the Apache V2 License. See LICENSE for more information.
This project adheres to the Adobe Code of Conduct. By participating, you are expected to uphold this code.
Security issues shouldn't be reported on the issue tracker. Instead, file an issue to our security experts.