Skip to content
Porulle Porulle

Packages

Every package below ships from this monorepo, lives under the @porulle/* scope on npm, and is versioned in lockstep through Changesets.

Terminal window
bun add @porulle/core @porulle/adapter-postgres @porulle/adapter-stripe

32 packages   v0.1.0 alpha

Core

Section titled “Core”

The four packages every Porulle install touches — kernel, CLI, database, SDK.

@porulle/core The kernel — services, adapters, hooks, state machines, auth, runtime. Everything else composes on top of it.
@porulle/cli Command-line tool. Scaffolds new stores, runs migrations, mints API keys, doctors broken setups.
@porulle/db The database surface plugins use instead of importing Drizzle directly.
@porulle/sdk Typed TypeScript client for any Porulle server. Generated from the OpenAPI spec — every endpoint type-checked at compile time.

Adapters

Section titled “Adapters”

Pluggable infrastructure — pick a database, payment processor, storage backend, search engine, mailer, or tax calculator. Vendor SDKs never leak into core.

Database

Section titled “Database”
@porulle/adapter-postgres The PostgreSQL DatabaseAdapter for @porulle/core. Drizzle on postgres-js. The only database backend Porulle ships today.

Payment

Section titled “Payment”
@porulle/adapter-stripe PaymentAdapter for Stripe. The reference implementation of the payment-adapter contract.

Storage

Section titled “Storage”
@porulle/adapter-s3 StorageAdapter for AWS S3 (or any S3-compatible bucket — DigitalOcean Spaces, MinIO, Backblaze B2).
@porulle/adapter-r2 StorageAdapter for Cloudflare R2 on Cloudflare Workers. Receives the R2 binding directly — no AWS SDK, no credentials in env.
@porulle/adapter-local-storage Filesystem StorageAdapter for development and single-node deployments. Not for production.
Section titled “Search”
@porulle/adapter-pg-search SearchAdapter powered by PostgreSQL full-text search (tsvector + tsquery). Zero extra infrastructure.
@porulle/adapter-meilisearch SearchAdapter for Meilisearch. Indexes catalog entities and answers /api/search and /api/search/suggest queries.

Email

Section titled “Email”
@porulle/adapter-resend Transactional email via Resend. Implements the email.send callback in CommerceConfig.
@porulle/adapter-ses Transactional email via AWS SES v2.

Tax

Section titled “Tax”
@porulle/adapter-tax-manual TaxAdapter that applies a single flat rate. For stores that need basic tax math without a third-party service.
@porulle/adapter-taxjar TaxAdapter for TaxJar. Calculates sales tax, files transactions, and voids them on refund.

Plugins

Section titled “Plugins”

Optional commerce capabilities — each one extends the kernel through hooks, routes, schema, and permission scopes. Install only what you need.

Retail and POS

Section titled “Retail and POS”
@porulle/plugin-pos In-store POS: terminals, shifts with cash events, transactions (sale/return/exchange), payments, barcode lookup, returns, receipts.
@porulle/plugin-pos-restaurant Restaurant layer on plugin-pos: tables, floor zones, modifiers, KDS, checklists, alerts, recipes (food BOM), analytics.

Customer engagement

Section titled “Customer engagement”
@porulle/plugin-loyalty Points, tiers, leaderboard, and redemption offers tied to customers per organization.
@porulle/plugin-giftcards Stored-value gift cards with balance checks, checkout redemption, issuance from qualifying purchases, admin lifecycle.
@porulle/plugin-reviews Customer reviews on catalog entities with moderation, replies, and aggregate summaries.
@porulle/plugin-wishlist Per-customer saved items for later purchase, with admin listing across users.
@porulle/plugin-notifications Templates, multi-channel send, customer preferences, notification log, print jobs. Pluggable SMS / push / print adapters.
@porulle/plugin-appointments Headless booking — service types, providers, availability, customer appointments with slot-based scheduling.
@porulle/plugin-scheduled-orders Defer order execution: schedule future placement and process due schedules in batch.

Multi-vendor and marketplace

Section titled “Multi-vendor and marketplace”
@porulle/plugin-marketplace Production-grade headless multi-vendor marketplace. Vendors, vendor catalogs, payouts, commission rules, vendor portals.

Supply chain and operations

Section titled “Supply chain and operations”
@porulle/plugin-procurement Suppliers with catalog links, purchase orders through approval, goods-received notes for inbound receiving.
@porulle/plugin-warehouse Inter-warehouse stock transfers with approval and dispatch/receive, wastage notes, stock reconciliations.
@porulle/plugin-production Bill of materials (BOM), cost rollup, explosion, production orders with material consumption tracking.
@porulle/plugin-uom Units of measure, conversions between units, per-entity UOM assignments for catalog and operations.

Importers

Section titled “Importers”

One-shot tools for pulling existing catalogs into Porulle.

@porulle/import-shopify Import a Shopify store's catalog. Maps product / variant / option / image onto sellable_entities, variants, option_types, option_values, entity_media.
@porulle/import-woocommerce Import a WooCommerce store's catalog. Maps product / variation / attribute / image onto Porulle's catalog model.
@porulle/import-flat Import catalog entities from a flat JSON file. The lowest-friction format — define an array of products, run porulle import, done.

Versioning

Section titled “Versioning”

Every package above is published in lockstep — a Patch / Minor / Major bump on one bumps all of them. This is enforced by the Changesets fixed group in .changeset/config.json.

To propose a version bump from a contributor PR:

Terminal window
bun run changeset

Pick the affected packages, the bump kind, and write a one-line summary. The release script handles the rest at merge time:

Terminal window
bun run release

Source is in packages/ on GitHub.