Documentation

Welcome to the TerraDart docs.

Guides track the 0.28.x line on pub.dev. The repo README and examples stay the deepest references; this site mirrors onboarding and release expectations.

Packages

TerraDart is organized as a multi-package monorepo:

• terradart_core — Core runtime primitives (Stack, Resource, Provider, Data, TfArg, synth/write behavior).
• terradart_google — Curated factories for Google Cloud (hashicorp/google).
• terradart_google_beta — Curated factories for beta-only Google Cloud resources (hashicorp/google-beta).
• terradart_appwrite — Curated factories for Appwrite (appwrite/appwrite).
• terradart_cloudflare — Curated factories for Cloudflare edge infrastructure (cloudflare/cloudflare, filled at 5.23.0: 257 resource factories + 446 data sources).
• terradart_agent — MCP server (terradart-mcp) exposing the curated catalog to AI coding agents.
• terradart_codegen — Maintainer generation CLI (terradart wrap).
• terradart_migrate — HCL → Dart migrator (terradart-migrate), reading Terraform through terradart_hcl.

Guides

• Getting Started — install, first *.tf.json, boundary export
• Why TerraDart — motivation, comparison, and curated coverage
• Architecture — generate *.tf.json, synth() / writeTo(), AppExport
• Coverage — every curated factory, its barrel, and runnable examples
• How it’s built — the generation pipeline, verification harness, and sustainability
• Migrating from HCL — terradart-migrate: bring an existing Terraform tree into TerraDart with a plan that reports No changes
• Migrating — breaking-change guides for minor bumps
• Status & versioning — alpha, path to beta, 1.0

For AI assistants

• terradart-mcp — MCP catalog server for coding agents (alpha)
• llms.txt — condensed site map for LLM crawlers