Projects

A project is the top-level organizational unit in Storelayer. Each project operates as a fully isolated environment with its own customers, wallets, promotions, and configuration.

Overview

Projects provide multi-tenancy at the infrastructure level. When you create a project, Storelayer provisions:

A dedicated Durable Object for state management
Isolated D1 database tables
A separate tenant worker for custom business logic
Independent API keys and authentication

Project Structure

Project
├── Customers (External Users)
├── Wallets (Points & Ledger)
├── Promotions (Discounts & Coupons)
├── Loyalty Events
├── Referral Programs
├── Catalog (Products)
├── Stores (Locations)
├── Workflows (Automations)
└── Settings & API Keys

Creating a Project

Projects are created through the dashboard or API:

curl -X POST https://api.storelayer.io/v1/projects \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Loyalty Program"}'

Project Membership

Users can be members of multiple projects. Each membership has a role:

Role	Permissions
Owner	Full access, manage members, delete project
Admin	Manage resources, API keys, settings
Member	Read/write access to resources