convez.ai
AgenteDesenvolvimento WebAvançado
mattbutlerengineering

Matt Butler Engineering Monorepo

mattbutlerengineering/mattbutlerengineering

Stack full-stack TypeScript: React, Fastify, Pulumi, design system e agentes

Ver no GitHub
InicialPluginScore · de 0 a 100

Monorepo completo TypeScript para plataforma de gestão hotelaria, incluindo design system Rialto, apps React, serviços Fastify e infraestrutura Pulumi. Demonstra padrões avançados de organização com workspaces pnpm, automação por agentes Claude Code, e stack moderno de full-stack JavaScript.

Instalação

$npx convez-ai mattbutlerengineering/mattbutlerengineering

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 1 dia
Versão
v0.1.0
Issues abertas
49
Contribuidores
4

Casos de uso

  • Referência de arquitetura monorepo escalável com múltiplos apps e serviços
  • Implementação de design system em produção com Rialto
  • Automação de desenvolvimento com agents Claude Code
  • Infrastructure as Code com Pulumi em TypeScript

Veredito

Projeto maduro e bem-estruturado que serve como referência prática de arquitetura monorepo modern. Valo especialmente o design system Rialto integrado e o uso de agentes Claude para automação — mostra padrões reais de produção em escala.

README

A tradução para o português deste README ainda está na fila.

Matt Butler Engineering

CI License: MIT codecov ACMM Level 6

Build status: GitHub Actions runs CI checks on every PR. Verify changes locally with pnpm lint/typecheck/test. See CONTRIBUTING.md for details.

Monorepo for mattbutlerengineering.com -- a hospitality management platform with a design system, multiple frontend apps, and backend API services.

Tech Stack

  • Frontend: React 19, Vite, React Router
  • Backend: Fastify, Prisma, PostgreSQL
  • Design System: Rialto (custom React component library)
  • Monorepo: Turborepo + pnpm workspaces
  • Infrastructure: Pulumi (TypeScript), Cloudflare Workers, DigitalOcean App Platform
  • Auth: Auth0 (OIDC/JWT)
  • Testing: Vitest, Playwright
  • CI/CD: GitHub Actions

Quick Start

# Install dependencies
pnpm install

# Start everything (Postgres via Docker, schema sync, dev servers)
pnpm dev:local

This starts PostgreSQL in Docker, syncs all database schemas, and launches all dev servers.

Access Points

AppURL
Marketing sitehttp://localhost:3000
Hospitality apphttp://localhost:3002/hospitality
Users API (+ docs)http://localhost:3001/docs
Agent API (+ docs)http://localhost:3003/docs
Reservations API (+ docs)http://localhost:3004/docs

Project Structure

mattbutlerengineering/
├── apps/                     # Frontend applications
│   ├── gen/                  # Gen app (dynamic UI rendering)
│   ├── hospitality/          # Restaurant management SPA
│   ├── marketing/            # Public marketing site
│   └── rialto-web/           # Design system showcase
├── services/                 # Backend API services
│   ├── agent/                # Agent session management API
│   ├── reservations/         # Reservations and table management API
│   └── users/                # User management API
├── packages/                 # Shared libraries
│   ├── agent-core/           # Agent session runner and worktree management
│   ├── agent-test-utils/     # Test helpers for agent sessions
│   ├── api-client/           # Typed fetch client for frontend apps
│   ├── auth/                 # Auth utilities (React hooks + Fastify plugin)
│   ├── config/               # Shared ESLint, TypeScript, Prettier configs
│   ├── mcp-server/           # Infrastructure MCP server for Claude Code
│   ├── notifications/        # Email/SMS notification adapters
│   ├── observability/        # OpenTelemetry SDK wrapper
│   ├── rialto/               # Rialto design system (component library)
│   ├── rialto-catalog/       # Component catalog generator for Rialto
│   ├── rialto-plugin/        # Claude Code plugin for Rialto
│   ├── sentry/               # Sentry error tracking integration
│   └── types/                # Shared TypeScript type definitions
├── tools/
│   └── cli/                  # `mbe` CLI for dev, agents, and infrastructure
└── infrastructure/           # IaC, Docker, edge routing, DB migrations
    ├── docker/               # Docker Compose for local dev
    ├── migrate/              # Prisma migration runner (production)
    ├── pulumi/               # Pulumi TypeScript IaC
    └── worker/               # Cloudflare Worker edge router

AI Maturity (ACMM)

Measured against the AI Codebase Maturity Model (arXiv:2604.09388). Current scorecard: 104/108 criteria detected across 6 levels.

MetricValue
LevelL3 (Fully Autonomous)
Agent PR acceptance97%
Agent PR revert rate0%
CI flake rate0%

See docs/acmm.md for the full scorecard.

Commands

pnpm dev:local    # Start everything (Postgres + schema sync + dev servers)
pnpm dev          # Start dev servers (assumes Postgres is running)
pnpm build        # Build all packages and apps
pnpm test         # Run all tests
pnpm lint         # Lint all packages
pnpm typecheck    # Type-check all packages
pnpm clean        # Remove build artifacts and node_modules

Service-Specific

Each service follows the same pattern:

cd services/<name>
pnpm dev              # Dev server with hot reload
pnpm test             # Run tests
pnpm test:coverage    # Test coverage report
pnpm db:migrate       # Run database migrations
pnpm db:studio        # Open Prisma Studio

CLI (mbe)

mbe agent run "Fix the login bug"    # Run an AI agent to fix an issue
mbe agent orchestrate "Big task"     # Decompose and run in parallel

See tools/cli/ for the full command reference.

Development

See CLAUDE.md for detailed development guidelines including:

  • Code style and naming conventions
  • API patterns and error handling
  • Testing structure and mocking
  • Database migration workflows
  • Deployment architecture

License

MIT © 2026 Matt Butler

Contributions welcome — see CONTRIBUTING.md, docs/review-criteria.md, and CODE_OF_CONDUCT.md. For security disclosures, see SECURITY.md.

Ver o original no GitHub

Bom para

Relacionados