Documentation Index
Fetch the complete documentation index at: https://mintlify.com/rifandani/be-monorepo/llms.txt
Use this file to discover all available pages before exploring further.
NPM Scripts
The BE Monorepo uses npm scripts for common development tasks. Scripts are defined at both the root level and within individual apps.
Root-Level Scripts
These scripts run from the repository root and affect the entire monorepo.
Development Scripts
prepare
Initializes Husky git hooks for the repository.
compose:up
Starts Docker services defined in docker/docker-compose.yml with build.
Code Quality Scripts
Formats code using Ultracite formatter.
Formats code with unsafe transformations enabled.
lint
Checks code for linting issues using Ultracite.
lint:fix
Automatically fixes linting issues where possible.
lint:doctor
Runs diagnostic checks on the linting configuration.
typecheck
Runs TypeScript type checking across all apps in parallel.
lint-typecheck
Runs both linting and type checking in parallel.
Maintenance Scripts
clean
Removes all build artifacts, dependencies, and lock files, then reinstalls dependencies. Useful for resolving dependency issues.
bump:deps
Checks for dependency updates using npm-check-updates. See Upgrading Dependencies for more details.
Changeset Scripts
Creates a new changeset for version management.
cs:v
Versions packages based on changesets. See Changesets for more details.
Hono App Scripts
These scripts target the @workspace/hono app specifically.
Root Shortcuts
From the repository root, you can run Hono-specific commands:
hono
Executes commands in the Hono workspace with stack traces enabled.
hono:ci
Executes commands in the Hono workspace (CI mode without stack traces).
hono:typecheck
Runs type checking for the Hono app.
hono:test
Runs tests for the Hono app. See Testing for more details.
Hono-Specific Scripts
These scripts run within the apps/hono/ directory.
Development
dev
Starts the development server with hot reload using development environment.
dev:prod
Starts the development server with production environment variables.
node:dev
Starts the development server using Node.js runtime (development env).
node:dev:prod
Starts the development server using Node.js runtime (production env).
Building
node:build
Builds the app for Node.js deployment (development env).
node:build:prod
Builds the app for Node.js deployment (production env).
node:start
Starts the built Node.js app (development env).
node:start:prod
Starts the built Node.js app (production env).
Database Scripts
db:pull
Pulls database schema from the remote database.
db:push
Pushes local schema changes to the database (verbose, strict mode).
db:gen
Generates database migrations from schema changes.
db:migrate
Runs pending database migrations.
db:studio
Opens Drizzle Studio at http://localhost:3003 for database exploration.
Authentication
auth:gen
Generates Better Auth schema types from the auth configuration.
Testing
test
Runs the test suite with Bun test using development environment variables.
Utilities
typecheck
Runs TypeScript type checking without emitting files.
ngrok
Exposes the local server at port 3333 through ngrok tunnel.
Script Naming Conventions
Prefixes
- No prefix: General-purpose commands (e.g.,
lint, test)
hono:: Commands that target the Hono app from the rootdb:: Database-related commandsauth:: Authentication-related commandsnode:: Node.js-specific runtime commandscs:: Changeset-related commands
Suffixes
:fix: Automatically fixes issues (e.g., lint:fix):unsafe: Performs potentially breaking operations (e.g., format:unsafe):ci: Optimized for CI environments:prod: Uses production environment variables
Running Scripts
All scripts use Bun as the package manager and runtime:
# Run from root
bun run <script-name>
# Run from app directory
cd apps/hono
bun run <script-name>
bun run --parallel <script1> <script2>
