npm package: @regardio/dev
Description: Regardio developer tooling for testing, linting, and build workflows
Author: Bernd Matzner
Latest version: 1.21.0

# @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

```bash
pnpm add -D @regardio/dev
```

Extend the shared configs in your project:

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

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

## Documentation

Detailed documentation is organized by topic:

### Concepts

- [AI Agents](./docs/en/agents.md) - Instructions for AI coding assistants
- [API](./docs/en/coding/api.md) - API design and implementation guidelines
- [Coding](./docs/en/coding/coding.md) - TypeScript, React, and general patterns
- [Commits](./docs/en/conventions/commits.md) - Conventional commits and changelog generation
- [Documentation](./docs/en/conventions/documentation.md) - Documentation structure and conventions
- [Naming](./docs/en/conventions/naming.md) - Consistent naming across languages
- [Principles](./docs/en/coding/principles.md) - Code quality, architecture, maintainability
- [React](./docs/en/coding/react.md) - React and TypeScript development patterns
- [SQL](./docs/en/coding/sql.md) - PostgreSQL/Supabase schema styling and structure
- [Testing](./docs/en/conventions/testing.md) - Testing philosophy and patterns
- [Writing](./docs/en/conventions/writing.md) - Voice, tone, and language for content

### Toolchain

- [Biome](./docs/en/tools/biome.md) - Linting and formatting
- [Commitlint](./docs/en/tools/commitlint.md) - Commit message validation
- [Dependencies](./docs/en/tools/dependencies.md) - Safe dependency updates and supply-chain controls
- [Husky](./docs/en/tools/husky.md) - Git hooks
- [Markdownlint](./docs/en/tools/markdownlint.md) - Markdown quality
- [Playwright](./docs/en/tools/playwright.md) - End-to-end testing
- [Releases](./docs/en/tools/releases.md) - GitLab-flow-based versioning and releases
- [TypeScript](./docs/en/tools/typescript.md) - Strict TypeScript configuration
- [Vitest](./docs/en/tools/vitest.md) - 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](https://regard.io)

## Acknowledgments

Built on the shoulders of giants: [Biome](https://biomejs.dev/), [TypeScript](https://www.typescriptlang.org/), [Vitest](https://vitest.dev/), [Playwright](https://playwright.dev/), [Vite](https://vitejs.dev/), and the entire open source ecosystem.