Skip to content

Projects & tags

A project is just a name + env that stick to everything you create. That's how list, share, and destroy know what's yours.

Init

bash
awsutopia init my-app --env dev
awsutopia init my-app --env staging --force   # overwrite

Writes .awsutopia/project.json:

json
{
  "version": 1,
  "name": "my-app",
  "env": "dev",
  "createdAt": "…"
}

Default env is dev when omitted. No YAML required.

Tags

Every created resource gets:

KeyValue
utopia:projectProject name
utopia:envEnvironment

Those tags gate destroy and share (current project match by default). Switch folders / re-init if you're jumping between apps. Escape hatch: --force on destroy/share for other utopia-tagged resources. See Destroy policy.

Working name — your AWS account, your bill.