Modules

Every BRAD module that ships in the box, what it does, and how they fit together.

4 min readmodules

BRAD's feature surface is built out of modules. The core platform handles users, roles, permissions, sessions, files, settings, real-time transport, and i18n โ€” everything past that is a module you can enable, disable, or build yourself.

Fifteen modules ship in the box. Enable only what you need; the rest stay dormant.

Modules show up in Admin โ†’ Modules, where you can install, enable, disable, or run pending migrations. Module migrations run automatically on every boot, so most of the time you'll never touch this โ€” it's there for when you want explicit control.

Business operations

The day-to-day tools for running the business itself.

ModuleWhat it does
Invoicing ๐Ÿ’ฐComplete invoicing with items, fees, taxes, and payment tracking. Provides hooks other modules use to create and manage invoices (the auction module hooks in here for winning bids, for example).
Support ๐ŸŽซCustomer support ticket system with real-time updates, department routing, and live chat.
Time Clock โฑ๏ธStaff time tracking and payroll. Clock in/out, IP restrictions, pay-period configuration, and payroll reports.
Appraisal ๐Ÿ“‹Professional appraisal management for equipment, real estate, vehicles, and other assets. Track items, valuations, client info, and generate appraisal reports.

Commerce

Selling things โ€” flexible enough to cover anything from a t-shirt shop to a car dealership to a live auction floor.

ModuleWhat it does
Sales ๐Ÿ›’Flexible ecommerce module for managing inventory and listings with custom attributes. Cart, checkout, filtering, advanced search.
Auction ๐Ÿ”จLive auctions with countdown timers, real-time bidding, and comprehensive auction management. Depends on Invoicing.
Collections ๐Ÿ—‚๏ธManage collections of items with flexible metadata fields. Assign collections to users; integrates with Auction and other item-based modules.

Content & publishing

ModuleWhat it does
Blog โœ๏ธFull-featured blog with categories, tags, comments, likes, and rich media. Admin management plus the public-facing frontend.
Podcasting ๐ŸŽ™๏ธSelf-hosted live streaming. Broadcast to your audience via local WebRTC or Cloudflare Stream. Multi-platform restreaming and chat aggregation are on the roadmap.

Communication

ModuleWhat it does
Collaboration ๐Ÿ’ฌDiscord/Slack-style real-time text chat with channels, permissions, and typing indicators.
Marketing ๐Ÿ“ฃEmail blasts, SMS blasts, and social-media management. Dry-run support, list management, and scheduling.

Project management

ModuleWhat it does
Projects ๐Ÿ“‹Spaces, boards, tasks, sprints, wiki pages, and a company calendar. Role-based access, recurring tasks, and team collaboration.

Operations & dev

ModuleWhat it does
Monitor ๐Ÿ“ŠReal-time visitor monitoring and session tracking via WebSocket.
Debug Tools ๐Ÿ”งDevelopment and debugging utilities including database visualization and inspection. Useful in dev; disable in production.

Reference

ModuleWhat it does
Example ๐ŸงชA demo module that exercises every extension point โ€” controllers, routes, settings, hooks, migrations, dashboard widgets, profile tabs, AI tools, broadcast/conference helpers. Use it as a starting template when you build your own.

What's NOT a module

Some things look like they should be modules but aren't โ€” they're part of the core platform and are always present:

  • Users, roles, and permissions โ€” every install has these; modules just register their own permissions which get auto-granted to admin-type roles.
  • Authentication and sessions โ€” including 2FA, password resets, magic links.
  • File uploads and storage โ€” unified file system used by every module. Local disk, Cloudflare Images, S3, R2, and GCS providers ship in core.
  • Settings and company config โ€” branding, currency, sender addresses, themes.
  • Email / SMS providers โ€” SendGrid, SMTP, Twilio. Modules consume these via the communication service.
  • Payment gateways โ€” Stripe (Cards, Apple/Google Pay, Terminal). Modules consume via the payment-gateway service.
  • AI agents โ€” the runtime exists in core; modules contribute tools via their own tools.ts.
  • Real-time transport โ€” Socket.IO + cluster/Redis adapters. Modules subscribe via the WebSocket service.
  • Page builder, blog comments engine, etc. โ€” page builder is core; comment infrastructure is core (modules like Blog plug into it).

Building your own

Modules are the supported extension mechanism. If you want to add a feature that isn't in the catalog, you write a module โ€” not patches to core.

โ†’ Read Create your own module for the file structure, manifest schema, and the canonical example.