@regardio/dev

A unified developer toolchain for consistent, high-quality TypeScript projects.

Purpose

@regardio/dev provides a complete, opinionated development environment that can be adopted by any JavaScript/TypeScript project. It bundles best-in-class tools with sensible defaults, enabling teams to focus on building features rather than configuring tooling.

One dependency. Zero configuration conflicts. Consistent quality across all projects.

Philosophy

We believe in balanced strictness: rigorous enough to catch bugs early and maintain consistency, yet practical enough to not impede development velocity.

• Strict by default - TypeScript strict mode, comprehensive linting, conventional commits
• Sensible defaults - Shared configs that work out of the box
• Minimal boilerplate - Extend presets, override only what's necessary
• Fast feedback - Quick linting and type checking during development

The goal is code that's correct, consistent, and a pleasure to work with.

What's Inside

Category	Tools
Linting	Biome, Markdownlint, Commitlint
Testing	Vitest, Playwright, Testing Library
Build	TypeScript, tsx, Vite
Workflow	Husky, GitLab Flow
CLI utilities	exec-clean, exec-p, exec-s, exec-tsc, ship-staging, ship-production, ship-hotfix, lint-biome, lint-md, lint-package

Quick Start

pnpm add -D @regardio/dev

Extend the shared configs in your project:

// biome.jsonc
{ "extends": ["@regardio/dev/biome"] }

// tsconfig.json
{ "extends": "@regardio/dev/typescript/base.json" }

Documentation

Detailed documentation is organized by topic:

Concepts

• AI Agents - Instructions for AI coding assistants
• API - API design and implementation guidelines
• Coding - TypeScript, React, and general patterns
• Commits - Conventional commits and changelog generation
• Documentation - Documentation structure and conventions
• Naming - Consistent naming across languages
• Principles - Code quality, architecture, maintainability
• React - React and TypeScript development patterns
• SQL - PostgreSQL schema styling, structure, and access control
• Testing - Testing philosophy and patterns
• Writing - Voice, tone, and language for content

Toolchain

• Biome - Linting and formatting
• Commitlint - Commit message validation
• Dependencies - Safe dependency updates and supply-chain controls
• Husky - Git hooks
• Markdownlint - Markdown quality
• Playwright - End-to-end testing
• Releases - GitLab-flow-based versioning and releases
• TypeScript - Strict TypeScript configuration
• Vitest - Unit and integration testing

Portability

While designed for Regardio projects, this toolchain follows well-established standards and can be adopted by any TypeScript project:

• All configs extend official tool presets
• No proprietary conventions or lock-in
• Standard npm package distribution
• MIT licensed

License

MIT © Regardio

Acknowledgments

Built on the shoulders of giants: Biome, TypeScript, Vitest, Playwright, Vite, and the entire open source ecosystem.