Library Overview — Boundary Docs

Boundary is a monorepo of 22 libraries publishable to Clojars, plus developer tooling. Every library follows the same FC/IS structure, making the codebase instantly familiar across libraries.

Foundation

Library	Purpose
core	Foundation: validation framework, case/type conversion utilities, interceptor pipeline, feature flags. No shell layer — entirely pure functions.
observability	Cross-cutting observability: structured logging, metrics, tracing breadcrumbs, and pluggable error reporters (Datadog, Sentry).
platform	HTTP routing/interceptors, database integration, CLI/runtime wiring. Infrastructure for feature libraries.
ui-style	Shared UI contract: centralized CSS/JS bundles, tokens, and reusable style conventions across libraries.
i18n	Internationalisation: marker-based translation, locale chain resolution, EDN catalogues, Ring middleware, and Babashka tooling.

Library

Purpose

core

Foundation: validation framework, case/type conversion utilities, interceptor pipeline, feature flags. No shell layer — entirely pure functions.

observability

Cross-cutting observability: structured logging, metrics, tracing breadcrumbs, and pluggable error reporters (Datadog, Sentry).

platform

HTTP routing/interceptors, database integration, CLI/runtime wiring. Infrastructure for feature libraries.

ui-style

Shared UI contract: centralized CSS/JS bundles, tokens, and reusable style conventions across libraries.

i18n

Internationalisation: marker-based translation, locale chain resolution, EDN catalogues, Ring middleware, and Babashka tooling.

Application

Library	Purpose
user	Authentication, authorization, MFA (TOTP), session management, JWT tokens.
admin	Auto-generated CRUD admin UI from schema. Hiccup + HTMX, no frontend build step.
storage	File storage: local filesystem and AWS S3 / S3-compatible backends.
scaffolder	Interactive module code generator. Generates FC/IS modules with tests and migrations.
cache	Distributed caching with TTL, atomic operations, and multi-tenant isolation. Redis and in-memory backends.
jobs	Background job processing with priority queues, retries, exponential backoff, multi-tenant support.
email	Email sending: SMTP, async, and queued via jobs integration.
tenant	Multi-tenancy with PostgreSQL schema-per-tenant isolation. Requires PostgreSQL.
realtime	WebSocket real-time communication, JWT auth, topic-based pub/sub.

Library

Purpose

user

Authentication, authorization, MFA (TOTP), session management, JWT tokens.

admin

Auto-generated CRUD admin UI from schema. Hiccup + HTMX, no frontend build step.

storage

File storage: local filesystem and AWS S3 / S3-compatible backends.

scaffolder

Interactive module code generator. Generates FC/IS modules with tests and migrations.

cache

Distributed caching with TTL, atomic operations, and multi-tenant isolation. Redis and in-memory backends.

jobs

Background job processing with priority queues, retries, exponential backoff, multi-tenant support.

Email sending: SMTP, async, and queued via jobs integration.

tenant

Multi-tenancy with PostgreSQL schema-per-tenant isolation. Requires PostgreSQL.

realtime

WebSocket real-time communication, JWT auth, topic-based pub/sub.

Extensions

Library Purpose

Library	Purpose
external	External service adapters: Twilio SMS/WhatsApp, SMTP/IMAP.
payments	Payment provider abstraction: Stripe, Mollie, and Mock adapters with checkout-session flow and webhook verification.
workflow	Declarative state machine workflows with permission-based transitions and audit trail.
search	Full-text search: PostgreSQL FTS with LIKE fallback for H2/SQLite.
reports	PDF, Excel (XLSX), and Word (DOCX) generation via `defreport` macro.
calendar	Recurring events, RRULE recurrence (DST-aware), iCal export/import, conflict detection.
geo	Geocoding (OSM/Google/Mapbox), DB-backed cache, rate limiting, Haversine distance.
ai	Framework-aware AI tooling: NL scaffolding, error explainer, test generator, SQL copilot, docs wizard.

external

External service adapters: Twilio SMS/WhatsApp, SMTP/IMAP.

payments

Payment provider abstraction: Stripe, Mollie, and Mock adapters with checkout-session flow and webhook verification.

workflow

Declarative state machine workflows with permission-based transitions and audit trail.

Full-text search: PostgreSQL FTS with LIKE fallback for H2/SQLite.

reports

PDF, Excel (XLSX), and Word (DOCX) generation via defreport macro.

calendar

Recurring events, RRULE recurrence (DST-aware), iCal export/import, conflict detection.

geo

Geocoding (OSM/Google/Mapbox), DB-backed cache, rate limiting, Haversine distance.

Framework-aware AI tooling: NL scaffolding, error explainer, test generator, SQL copilot, docs wizard.

Developer Tooling

These libraries are not published to Clojars — they are part of the monorepo and available automatically.

Library	Purpose
devtools	Dev-only: error pipeline (BND codes), dev dashboard (localhost:9999), REPL power tools, guidance engine, request recording, AI REPL commands.
tools	Dev-only: deploy to Clojars, config doctor, setup wizard, scaffolder integration, quality checks, i18n management.

Library

Purpose

devtools

Dev-only: error pipeline (BND codes), dev dashboard (localhost:9999), REPL power tools, guidance engine, request recording, AI REPL commands.

tools

Dev-only: deploy to Clojars, config doctor, setup wizard, scaffolder integration, quality checks, i18n management.

Clojars coordinates

All libraries share the org.boundary-app group:

{org.boundary-app/boundary-core      {:mvn/version "1.0.1-alpha-14"}
 org.boundary-app/boundary-user      {:mvn/version "1.0.1-alpha-14"}
 org.boundary-app/boundary-admin     {:mvn/version "1.0.1-alpha-14"}
 org.boundary-app/boundary-platform  {:mvn/version "1.0.1-alpha-14"}
 ;; etc.
 }