Voyant

Voyant is an open-source framework for travel companies. It ships starter apps, durable workflow orchestration, and a wide set of headless domain modules — CRM, products, availability, bookings, finance, distribution, resources, legal, charters, cruises, and more — that you can compose into your own travel platform.

CLI | DMC Template | Operator Template | Packages | Examples | Migrations

Get started

1. Install the CLI

npm install -g @voyantjs/cli

You can also use pnpm add -g @voyantjs/cli.

2. Scaffold a project from a starter

voyant new my-travel-app --template dmc
cd my-travel-app
pnpm install

Built-in starters are downloaded from the matching GitHub Release for your installed CLI version. You can also point --template at a custom local starter directory.

3. Configure the app

cp .dev.vars.example .dev.vars

Set your secrets in .dev.vars and provide DATABASE_URL in .env for Drizzle and local worker processes.

4. Run the app

pnpm db:migrate
pnpm dev

Starter templates

Voyant ships two first-party starters:

What you get

• Deployable application shells, not just isolated packages
• A normalized travel operations data model on PostgreSQL + Drizzle
• Headless domain modules for CRM, catalog, availability, bookings, finance, legal, resources, charters, cruises, and more
• Hono-based API transport with optional Next.js route helpers
• Step-based durable workflow orchestration that runs on Cloudflare Workers + Durable Objects, Node, or Voyant Cloud
• Better Auth wiring in first-party starters, with core packages staying auth-provider agnostic
• A shadcn-style component registry per domain (crm-ui, products-ui, bookings-ui, …) for installable UI blocks
• React hook libraries (crm-react, products-react, bookings-react, …) that wrap the HTTP contract of each module
• Optional integrations for payments, e-invoicing, storage, CMS sync, and notifications

The framework surface

Core platform

• @voyantjs/core, @voyantjs/db, @voyantjs/hono, @voyantjs/next, @voyantjs/react
• @voyantjs/auth, @voyantjs/auth-react, @voyantjs/types, @voyantjs/utils, @voyantjs/voyant-test-utils
• @voyantjs/cli, @voyantjs/storage, @voyantjs/i18n

Travel domain modules

• @voyantjs/crm, @voyantjs/suppliers, @voyantjs/products, @voyantjs/availability
• @voyantjs/booking-requirements, @voyantjs/resources, @voyantjs/transactions, @voyantjs/bookings
• @voyantjs/finance, @voyantjs/notifications, @voyantjs/checkout, @voyantjs/legal
• @voyantjs/distribution, @voyantjs/markets, @voyantjs/pricing, @voyantjs/extras, @voyantjs/sellability
• @voyantjs/facilities, @voyantjs/hospitality, @voyantjs/ground, @voyantjs/identity, @voyantjs/external-refs, @voyantjs/octo
• @voyantjs/charters, @voyantjs/cruises, @voyantjs/storefront, @voyantjs/customer-portal, @voyantjs/storefront-verification

Workflows (durable orchestration)

Step-based workflows with durable state, retries, and a shared wire protocol — runnable on Cloudflare Workers + Durable Objects, Node, or Voyant Cloud.

• @voyantjs/workflows — authoring SDK
• @voyantjs/workflows-orchestrator — reference orchestrator core
• @voyantjs/workflows-orchestrator-cloudflare and @voyantjs/workflows-orchestrator-node — runtime adapters
• @voyantjs/workflows-bindings, @voyantjs/workflows-config, @voyantjs/workflows-errors
• @voyantjs/workflows-react — UI hooks for run inspection

Reference apps under apps/ compose these into deployable shapes — workflows-orchestrator-worker, workflows-tenant-worker, workflows-selfhost-cloudflare-worker, workflows-selfhost-node-server, workflows-node-step-container, and workflows-local-dashboard.

UI registries and React families

Each domain module has matching -ui (shadcn registry source) and -react (hooks + provider) packages — for example @voyantjs/crm-ui + @voyantjs/crm-react, @voyantjs/bookings-ui + @voyantjs/bookings-react, and so on across products, finance, availability, distribution, markets, pricing, legal, resources, facilities, hospitality, suppliers, identity, external-refs, charters, cruises, extras, sellability, booking-requirements. The shared admin shell lives in @voyantjs/admin; cross-cutting primitives in packages/ui.

Plugins

• @voyantjs/plugin-netopia — Netopia payments
• @voyantjs/plugin-smartbill — SmartBill e-invoicing (Romanian tax compliance)
• @voyantjs/plugin-payload-cms — Payload CMS sync
• @voyantjs/plugin-sanity-cms — Sanity CMS sync

For contributors

This repository is the workspace that powers the framework, starters, runners, and examples.

Monorepo commands

Integration test database

The shared Docker test Postgres is defined in docker-compose.test.yml.

• default host port: 5436
• override with TEST_DATABASE_PORT
• override the full connection string with TEST_DATABASE_URL

For the bookings package, contributors can use:

pnpm test:bookings:integration

That helper starts or reuses the Docker test DB, applies template migrations, ensures the current additive bookings-session table exists, and runs the bookings DB-backed integration files serially to avoid deadlocks from concurrent table truncation.

Architecture

Voyant keeps a strict boundary:

• packages/* hold reusable business logic, schemas, services, routes, adapters, and contracts
• templates/* and app shells own UI, auth wiring, deployment shape, and runtime-specific configuration
• Core packages stay framework-agnostic even when first-party starters use React, TanStack Start, Hono, Better Auth, and Cloudflare Workers
• Transport adapters stay thin and call shared domain services rather than owning business logic
• Workflow business logic ships as plain SDK packages; orchestrator/runner apps wrap them for a given runtime

Architecture decisions live in docs/adr/; domain conventions live in docs/architecture/; per-minor migration notes live in docs/migrations/.

Security model

One Postgres database + one runtime per organization. Tenancy is enforced at the deployment boundary, not by in-process middleware. See ADR-0001 for the full rationale, the alternatives considered, and the conditions under which the decision should be revisited.

Credits

Voyant is created and maintained by PixelMakers.

License

Apache License, Version 2.0 (Apache-2.0). See LICENSE.