ARCHE
FamiliesDocsExamplesBlogGitHub ↗
Documentation

Start

  • Getting started
  • Philosophy

Guides

  • First hour
  • Agent context
  • Verification
  • Package managers
  • Scaffold lifecycle
  • Showcase & portfolio

Walkthroughs

  • TypeScript fullstack
  • Convex product
  • Rust API & fullstack
  • Solana family
  • Customize & experiments
  • Automation (JSON/MCP)

CLI

  • Overview
  • Flags
  • Subcommands
  • Generated output

Presets

  • Preset catalog

Stack

  • TypeScript architecture
  • Convex
  • Rust
  • Solana
  • Authentication
  • Prisma store
  • tRPC

Operations

  • Deployment
  • Environment variables
  • Workers & queues
  • CI & testing
  • Scaling
  • Security
  • Troubleshooting

Reference

  • Stack links
  • Capabilities
  • This source repo
  • Code examples
← Documentation

Package managers

Bun default, pnpm first-class, catalogs, and what each preset supports.

1 min read

Arche defaults to Bun for installs and scripts. pnpm is first-class on routes where the verification matrix records pnpm: yes (today: typescript-fullstack). npm is experimental—use only when testing compatibility.

At scaffold time

terminal
bun run dev:cli -- my-app --yes --preset=typescript-fullstack --dir=../projects

The CLI writes:

  • Bun: package.json → workspaces.catalog
  • pnpm: pnpm-workspace.yaml → catalog:

Shared versions come from toolings/catalog/workspace-catalog.json in the template and are replayed into generated repos.

After scaffold

Use the package manager you selected—do not mix lockfiles without intent.

terminal
# Bun generated project
bun install
bun run ci

# pnpm generated project (when enabled)
pnpm install
pnpm run ci

Generated AGENTS.md lists the exact scripts for that tree.

Preset support

Check the verification matrix—if pnpm is — for your preset, assume Bun unless you have verified output yourself.

This source repository

Developing Arche itself always uses Bun at the repo root. Commands on This source repository apply here—not inside every generated app.

Policy summary

ManagerRole
BunDefault for new scaffolds and this template repo
pnpmSupported on verified presets; catalog parity with Bun
npmExperimental; not the stability target