Putnami
DocsGitHub

Licensed under FSL-1.1-MIT

Getting Started
Concepts
How To
Build A Web App
Build An Api Service
Share Code Between Projects
Configure Your App
Add Persistence
Add Authentication
Add Background Jobs
Principles
Tooling & Workspace
Workspace Overview
Cli
Jobs & Commands
SDK
Error Handling
Extensions
Typescript
Go
Python
Docker
Ci
Frameworks
Typescript
OverviewWebReact RoutingForms And ActionsStatic FilesApiErrors And ResponsesConfigurationLoggingHttp And MiddlewareDependency InjectionPlugins And LifecycleSessionsAuthPersistenceEventsStorageCachingWebsocketsTestingHealth ChecksTelemetryProto GrpcSmart Client
Go
OverviewHttpDependency InjectionPlugins And LifecycleConfigurationSecurityPersistenceErrorsEventsStorageCachingLoggingTelemetryGrpcService ClientsValidationOpenapiTesting
Platform
  1. DocsSeparator
  2. Tooling & Workspace

Tooling & Workspace

This section explains how Putnami organizes a workspace, how the CLI discovers commands, and how jobs are orchestrated across projects.

If you're new to Putnami, follow the order below as a guided learning path.

  • Workspace overview — what a workspace is, why it matters, and how projects are discovered
  • CLI — commands, targets, and global flags
  • Jobs & commands — orchestration, dependencies, caching, and scope resolution
  • SDK — APIs for building commands, jobs, and plugins
  • Error handling — retry strategies, continue-on-error, and error types
  • Extensions — official tooling plugins and how to add your own
  • TypeScript — TypeScript build/test/lint workflows
  • Go — Go build/test/lint workflows
  • Python — Python build/test/lint workflows
  • Docker — container build and publish workflows
  • CI — CI/CD automation, releases, and git hooks

On this page

  • Tooling & Workspace