Addons

Addons extend your Better-T-Stack project with additional tools and features. You can select multiple addons during project creation or add them later.

Tooling Addons

Turborepo

High-performance build system for JavaScript and TypeScript monorepos.What’s Included:

Intelligent build caching
Parallel task execution
Remote caching support
Pipeline configuration
Optimized development workflows

Best For:

Multi-package monorepos
Large teams
CI/CD optimization
Fast incremental builds

Configuration:

turbo.json pipeline setup
Workspace task orchestration
Build output caching

Biome

Format, lint, and more in one fast tool.What’s Included:

Fast code formatting
Linting with auto-fix
Import sorting
Single configuration file
Near-instant execution

Best For:

Teams wanting all-in-one tooling
Fast formatting and linting
Replacing ESLint + Prettier
Modern JavaScript/TypeScript projects

Template Location: templates/addons/biome/Configuration File: biome.json

Oxlint

Oxlint + Oxfmt for blazing-fast linting and formatting.What’s Included:

Ultra-fast linting (50-100x faster than ESLint)
Fast formatting (oxfmt)
Rust-powered performance
Zero config defaults

Best For:

Maximum performance
Large codebases
Fast CI/CD pipelines
TypeScript projects

Note: Mutually exclusive with Biome and Ultracite.

Ultracite

Zero-config Biome preset with AI integration.What’s Included:

Pre-configured Biome setup
AI-powered code suggestions
Intelligent formatting rules
Smart linting presets

Best For:

Zero-configuration projects
AI-enhanced development
Teams wanting smart defaults
Rapid project setup

Note: Mutually exclusive with Biome and Oxlint.

Husky

Modern native Git hooks made easy.What’s Included:

Pre-commit hooks
Commit message linting
Pre-push hooks
Easy hook management

Best For:

Enforcing code quality
Commit conventions
Preventing bad commits
Team consistency

Template Location: templates/addons/husky/Configuration: .husky/ directory with hook scriptsNote: Mutually exclusive with Lefthook.

Lefthook

Fast and powerful Git hooks manager.What’s Included:

Fast parallel hook execution
YAML configuration
Cross-platform support
Multiple hook commands

Best For:

Performance-critical hooks
Complex hook workflows
Multi-command pre-commit checks
Fast CI-like local checks

Template Location: templates/addons/lefthook/Configuration File: lefthook.ymlNote: Mutually exclusive with Husky.

Documentation Addons

Starlight

Build stellar docs with Astro.What’s Included:

Astro-powered documentation site
Built-in search
Dark mode
Mobile-responsive
Multiple languages support
Sidebar navigation

Best For:

Astro-based projects
Content-focused documentation
Open source projects
Multi-language docs

Frontend Requirement: Astro must be selected

Fumadocs

Build excellent documentation sites.What’s Included:

Next.js-based documentation
MDX support
API reference generation
Search functionality
Component previews

Best For:

Next.js projects
API documentation
Component libraries
Complex documentation needs

Frontend Requirement: Next.js must be selected

Extension Addons

PWA

Make your app installable and work offline.What’s Included:

Service worker configuration
Web app manifest
Offline support
Install prompts
Icon generation
Cache strategies

Best For:

Installable web apps
Offline functionality
Mobile-first applications
Progressive enhancement

Template Locations:

Vite apps: templates/addons/pwa/apps/web/vite/
Next.js apps: templates/addons/pwa/apps/web/next/

Frontend Compatibility:

Vite-based frontends (TanStack Router, Svelte, Solid)
Next.js

Assets Included:

Logo files
Manifest generation
PWA configuration

Tauri

Build native desktop apps from your web frontend.What’s Included:

Rust-based native wrapper
Desktop app packaging
System tray support
Native menus
File system access
Cross-platform builds (Windows, macOS, Linux)

Best For:

Desktop applications
Cross-platform native apps
System integration needs
Lightweight native wrappers

Frontend Compatibility:

Most web frontends
Not compatible with React Native

OpenTUI

Build terminal user interfaces.What’s Included:

TUI component library
Terminal rendering
Interactive CLI components
Keyboard navigation

Best For:

CLI tools
Developer tools
Terminal applications
Interactive scripts

WXT

Build browser extensions.What’s Included:

Extension manifest generation
Cross-browser support (Chrome, Firefox, Safari)
HMR for development
TypeScript support
Extension APIs

Best For:

Browser extensions
Cross-browser tools
Productivity extensions
Content scripts

AI Addons

Ruler

Centralize your AI rules and context.What’s Included:

.ruler/ directory setup
ruler.toml configuration
Better-T-Stack context file
AI coding assistant integration
Project-specific rules

Best For:

AI-assisted development
Team coding standards
Context for AI tools
Consistent AI suggestions

Template Location: templates/addons/ruler/Files Created:

.ruler/ruler.toml: Configuration
.ruler/bts.md: Better-T-Stack context

Integration:

Works with Cursor, Windsurf, and other AI editors
Provides stack-specific context to AI

Skills

AI coding agent skills for your stack.What’s Included:

Stack-specific AI skills
Custom commands for AI agents
Framework-aware assistance
Best practices integration

Best For:

AI pair programming
Learning new frameworks
Consistent code patterns
Stack-specific guidance

MCP

Install MCP servers (docs, databases, SaaS) via add-mcp.What’s Included:

MCP server integration
Database MCP servers
Documentation access
SaaS integrations
Add-mcp tool configuration

Best For:

AI-enhanced workflows
External service integration
Documentation access for AI
Database interaction via AI

How It Works:

Installs add-mcp tool
Allows adding MCP servers post-creation
Connects AI to external services

Addon Compatibility

Mutually Exclusive Addons

Some addons cannot be used together:

Addon	Conflicts With	Reason
Biome	Oxlint, Ultracite	All provide formatting/linting
Oxlint	Biome, Ultracite	All provide formatting/linting
Ultracite	Biome, Oxlint	All provide formatting/linting
Husky	Lefthook	Both manage Git hooks
Lefthook	Husky	Both manage Git hooks

Frontend-Specific Addons

Some addons require specific frontends:

Addon	Required Frontend
Starlight	Astro
Fumadocs	Next.js
PWA (Vite)	TanStack Router, Svelte, Solid
PWA (Next.js)	Next.js
Tauri	Any web frontend (not React Native)

Adding Addons Later

You can add compatible addons after project creation:

# Future feature
bts add
# Select addons from the list

The bts add command will only show addons compatible with your current stack.

Addon Selection Strategy

Tooling First

Choose your code quality tools:

Biome: All-in-one, fast
Oxlint: Maximum speed
Ultracite: AI-enhanced, zero-config

Git Hooks

Add pre-commit checks:

Husky: Popular, well-known
Lefthook: Faster, YAML config

Monorepo Tools

If using multiple packages:

Turborepo: Build optimization

Documentation

If building docs:

Starlight: For Astro projects
Fumadocs: For Next.js projects

Extensions

Based on your needs:

PWA: Mobile-first web apps
Tauri: Desktop applications
WXT: Browser extensions
OpenTUI: CLI tools

AI Tools

Enhance development:

Ruler: Centralized AI context
Skills: Stack-specific AI skills
MCP: External service integration

Configuration Examples

{
  "$schema": "https://biomejs.dev/schemas/1.5.3/schema.json",
  "formatter": {
    "enabled": true,
    "indentStyle": "space"
  },
  "linter": {
    "enabled": true,
    "rules": {
      "recommended": true
    }
  }
}

Getting Started

CLI Reference

Configuration

Guides

Stack Options

Tooling Addons

Documentation Addons

Starlight

Fumadocs

Extension Addons

AI Addons

Addon Compatibility

Mutually Exclusive Addons

Frontend-Specific Addons

Adding Addons Later

Addon Selection Strategy

Configuration Examples

Next Steps

Project Structure

Development

Build docs developers (and LLMs) love

Getting Started

CLI Reference

Configuration

Guides

Stack Options

Documentation Index

​Tooling Addons

​Documentation Addons

Starlight

Fumadocs

​Extension Addons

​AI Addons

​Addon Compatibility

​Mutually Exclusive Addons

​Frontend-Specific Addons

​Adding Addons Later

​Addon Selection Strategy

​Configuration Examples

​Next Steps

Project Structure

Development

Build docs developers (and LLMs) love

Tooling Addons

Documentation Addons

Extension Addons

AI Addons

Addon Compatibility

Mutually Exclusive Addons

Frontend-Specific Addons

Adding Addons Later

Addon Selection Strategy

Configuration Examples

Next Steps