Quick Start with CLI

Scaffold your service
Terminal window
```
verikt new my-service
```
You’ll pick a service name, choose your language (Go or TypeScript), select an architecture (hexagonal, layered, clean, or flat), multi-select capabilities, and accept or skip smart suggestions.
Tip
Know exactly what you want? Skip the wizard:
Go
TypeScript
Terminal window
verikt new my-service \ --language go \ --arch hexagonal \ --cap platform,bootstrap,http-api,mysql,docker \ --module github.com/myorg/my-service \ --no-wizard
Terminal window
verikt new my-ts-api \ --language typescript \ --arch hexagonal \ --cap platform,bootstrap,http-api,docker \ --no-wizard

Explore what you got

Go
TypeScript

my-service/
├── cmd/my-service/main.go          # Thin entry point (15 lines)
├── internal/bootstrap/bootstrap.go # All dependency wiring
├── domain/                         # Business logic (zero deps)
│   ├── errors.go                   # Typed domain errors
│   └── clock.go                    # Testable time abstraction
├── port/                           # Interfaces
│   ├── inbound.go                  # Use case interfaces
│   └── outbound.go                 # Repository interfaces
├── service/                        # Use case implementations
├── adapter/                        # External integrations
│   ├── httphandler/                # REST API (Chi router)
│   └── mysqlrepo/                  # MySQL repositories
├── config/                         # YAML config loading
├── platform/                       # Logging, OTel, lifecycle
├── docs/PROJECT.md                 # Full project anatomy
├── verikt.yaml                    # Architecture rules
└── go.mod

my-ts-api/
├── src/
│   ├── domain/                     # Business logic (zero deps)
│   ├── application/                # Use cases and ports
│   ├── infrastructure/             # DB, external services
│   └── transport/                  # HTTP handlers
├── verikt.yaml                    # Architecture rules
├── package.json
└── tsconfig.json

Run it

Go
TypeScript

cd my-service
go run ./cmd/my-service

cd my-ts-api
npm install && npm run dev

Validate the architecture
Terminal window
```
verikt check
```
This catches dependency violations, missing directories, function complexity issues, and anti-patterns. Go uses 11 AST-based detectors; TypeScript uses tree-sitter import graph analysis.

Next Steps

How It Works — understand the composition model
Architectures — hexagonal vs flat
Capabilities — all capabilities explained