App Development
Build powerful apps that integrate with the Qumra ecommerce platform. Qumra Apps run as embedded iframes inside the Qumra admin panel, allowing store owners to extend their store functionality.
Quick Start
# 1. Install the Qumra CLI
npm install -g @qumra/cli
# 2. Login to your Qumra account
qumra user login
# 3. Create a new app
npx create-qumra-app my-app
# 4. Install dependencies
cd my-app && npm install
# 5. Start the development server
qumra app dev
Login Required
You must run qumra user login before creating or developing apps. The CLI authenticates via your browser and stores a session token locally.
Key Concepts
| Concept | Description | Learn More |
|---|---|---|
SDK (@qumra/app-sdk) | Server-side SDK for authentication, API calls, and webhook verification | SDK Docs |
| OAuth 2.0 | Secure authentication flow between your app and Qumra stores | Authentication |
| Webhooks | Real-time event notifications when store data changes | Webhooks |
| Iframe Integration | Your app renders inside the Qumra admin panel as an embedded iframe | Iframe Integration |
| GraphQL API | Query and mutate store data through the Qumra GraphQL API | API Reference |
Tech Stack
Qumra apps are scaffolded with a modern full-stack architecture:
| Technology | Version | Purpose |
|---|---|---|
| React | 19 | UI framework |
| React Router | 7 | File-based routing and SSR |
| TailwindCSS | 4 | Utility-first CSS |
| TypeScript | 5 | Type safety |
| Vite | 7 | Build tool and dev server |
| Prisma | 7 | Database ORM |
| SQLite | - | Default development database |
| Node.js | >= 18 | Runtime |
@qumra/app-sdk | latest | Qumra platform integration |