Monospace

Installation

Prerequisites and setup instructions for the Monospace monorepo.

Prerequisites

Before getting started, make sure you have the following installed:

  • Bun v1.3.4 or later — Runtime and package manager
  • Node.js v18 or later — Required by some tooling

Clone the Repository

git clone https://github.com/your-username/monospace.git
cd monospace

Install Dependencies

Run bun install from the monorepo root. This will install all dependencies for every package and app in the workspace:

bun install

Bun uses workspace linking to resolve @repo/* packages, so all shared packages are automatically available to every app.

Development

Start all apps in development mode simultaneously:

bun run dev

This runs turbo run dev, which uses Turborepo to start dev servers for every app in apps/.

Build

Build all apps for production:

bun run build

Output files are emitted to each app's dist/ directory.

Linting & Formatting

# Biome check (lint + format)
bun run format-and-lint

# Biome check with auto-fix
bun run format-and-lint:fix

# Prettier (markdown and TypeScript files)
bun run format

Type Checking

bun run check-types

This runs tsc --noEmit across all packages and apps via Turborepo.

On this page