Quick Checklist
Which repos you need depends on what you're prototyping.
| Repository | All | Core | Edge |
|---|---|---|---|
| kaptio-prototypes | ✓ | ✓ | ✓ |
| kaptio-flux (Flux design system) | ✓ | ✓ | ✓ |
| kaptiotravel (Salesforce package) | — | ✓ | — |
| ktapi (Python API backend) | — | ✓ | — |
| basket-service (Shopping basket API) | — | ✓ | — |
| kaptioconnect (Integration layer) | — | ✓ | — |
| edge-platform (Edge platform) | — | — | ✓ |
| edge-tenant-config (tenant config) | — | — | ✓ |
Base Workspace (Everyone)
Every prototype needs these two repos. Clone them as sibling directories and open both in your Cursor workspace.
kaptio-prototypes Required
This repo. Where your prototypes live and deploy from.
git clone git@gitlab.com:kaptio1/platform-and-services/edge/kaptio-prototypes.git
kaptio-flux Required
The Flux design system. Provides all --flux-* CSS tokens for colors, typography, spacing, radius, shadows, and motion. The agent reads src/tokens/flux.css and the full component gallery from this repo.
git clone git@gitlab.com:kaptio1/platform-and-services/edge/kaptio-forma.git
Full token gallery: flux.kaptio.com
Core Prototypes (Salesforce Product)
If you're prototyping features for the Kaptio Salesforce managed package, the API layer, or the booking/basket flow, add these repos so the agent understands the data model and service architecture.
kaptiotravel Core
The Salesforce managed package source. Contains Apex classes, custom object definitions, field metadata, LWC components, and trigger frameworks. Having this in the workspace lets the agent generate realistic mock data that matches the real object model.
git clone git@gitlab.com:kaptio1/kaptiotravel-salesforce/kaptiotravel.git
Key objects the agent will understand:
- Itinerary
- Package
- PackageDeparture
- Inventory
- Pricing
- Passengers
- Payments
- Services
- Suppliers
- Channels
- Person Account
ktapi Core
The Python API backend that sits between Salesforce and all consumer-facing applications. Handles search, booking, pricing, availability, and content delivery. Gives the agent knowledge of the REST API contracts, request/response shapes, and business logic.
git clone git@bitbucket.org:kaptio/ktapi.git
Capabilities the agent will understand:
- Search API
- Booking API
- Pricing engine
- Availability
- Content delivery
- Authentication
- Client configuration
basket-service Core
The shopping basket microservice. Manages basket state, item add/remove, pricing recalculation, and checkout flow. Essential context for prototyping any booking or e-commerce flow.
git clone git@gitlab.com:kaptio1/platform-and-services/services/basket-service.git
Concepts the agent will understand:
- Basket state
- Item management
- Price recalculation
- Checkout flow
- Passenger assignment
kaptioconnect Core
The integration and connector layer. Handles supplier connectivity, external system integrations, data synchronization, and transformation pipelines. Important context for prototyping anything involving supplier data or third-party integrations.
git clone git@gitlab.com:kaptio1/platform-and-services/services/kaptioconnect.git
Capabilities the agent will understand:
- Supplier integrations
- Data sync pipelines
- Transformation rules
- Connection management
- External APIs
Edge Prototypes (Document Generation Platform)
If you're prototyping features for Edge Docs, Edge Pay, Canvas, or the Viewer, add these repos so the agent understands the platform architecture and tenant config patterns.
edge-platform Edge
The Edge Platform application code. Contains all services (Admin Backend, Editor, Render Engine, Viewer, Payment, Canvas, Preferences, Quest), shared packages, and Salesforce LWC components. Gives the agent knowledge of the service architecture, API patterns, and UI conventions.
git clone git@gitlab.com:kaptio1/platform-and-services/edge/edge-platform.git
Services the agent will understand:
- Admin Backend
- Editor
- Render Engine
- Viewer
- Payment
- Canvas
- Preferences
- Quest
- Edge Save API
edge-tenant-config Edge
Tenant configuration repository. Contains blueprint YAML, Handlebars templates, JSON schemas, and SOQL data-transformation queries for every tenant. Lets the agent understand how documents are configured, what data flows through templates, and what real tenant setups look like.
git clone git@gitlab.com:kaptio1/platform-and-services/edge/edge-doc-engine-configs.git
Config types the agent will understand:
- blueprint.yaml
- Handlebars templates
- JSON schemas
- Data-transformation queries
- Payment config
- Email templates
How Cursor Rules Work
When you open repos in your Cursor workspace, the agent automatically reads their .cursorrules files. This gives it domain knowledge without you having to explain anything.
- kaptio-prototypes/.cursorrules — Enforces Flux design tokens, mock-data-only rule, one-folder-per-prototype structure. This is always active.
- kaptio-flux/.cursorrules — Contains the full Flux token reference. The agent can look up exact color values, spacing scales, and naming conventions.
- kaptiotravel/.cursorrules — Describes the Salesforce data model patterns, API conventions (KaptioQueryV2, KaptioUowV1), and naming conventions. Helps the agent generate accurate mock data.
- ktapi/.cursorrules — Describes the Python API backend structure, REST endpoints, and client configuration. Helps the agent understand API contracts and response shapes.
- basket-service/.cursorrules — Describes the basket microservice, checkout flow, and pricing recalculation patterns.
- kaptioconnect/.cursorrules — Describes the integration layer, supplier connectivity, and data transformation pipelines.
- edge-platform/.cursorrules — Describes the Edge platform architecture, service ports, monorepo structure, and TypeScript conventions. Helps the agent understand what Edge UIs look and feel like.
- edge-tenant-config/.cursorrules — Describes tenant config file structure, Handlebars template patterns, and data-transformation schemas.
Recommended Directory Layout
Clone all repos as siblings. Open the root folder in Cursor so all repos are in the workspace.
~/kaptio-prototyping/
kaptio-prototypes/ # This repo (your prototypes)
kaptio-flux/ # Flux design system
kaptiotravel/ # Core: Salesforce package (optional)
ktapi/ # Core: Python API backend (optional)
basket-service/ # Core: Shopping basket API (optional)
kaptioconnect/ # Core: Integration layer (optional)
edge-platform/ # Edge: platform code (optional)
edge-tenant-config/ # Edge: tenant config (optional)
Open ~/kaptio-prototyping/ as your Cursor workspace folder. All repos and their rules will be loaded automatically.