@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, Changesets | | CLI utilities | exec-clean, exec-p, exec-s, exec-ts, flow-release, 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

• Development Principles - Code quality, architecture, maintainability
• Coding Standards - TypeScript, React, and general patterns
• Naming Conventions - Consistent naming across languages
• Commit Conventions - Conventional commits and changelog generation
• Testing Approach - Testing philosophy and patterns
• AI Agent Guidelines - Instructions for AI coding assistants

Toolchain

• TypeScript - Strict TypeScript configuration
• Biome - Linting and formatting
• Vitest - Unit and integration testing
• Playwright - End-to-end testing
• Commitlint - Commit message validation
• Markdownlint - Markdown quality
• Husky - Git hooks
• Changesets - Versioning and releases

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.