# takomo

> Organize, configure and deploy CloudFormation stacks.

Latest version **11.1.0** (published 2026-09-26) · MIT license · 0 weekly downloads

## Install

```sh
npm install takomo
pnpm add takomo
yarn add takomo
bun add takomo
```

Provides the commands `tkm`, `takomo`.

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 11.1.0 |
| Published | 2026-09-26 |
| First published | 2020-04-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=26.5.1 |
| Dependencies | 38 |
| Unpacked size | 1.5 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| Author | henri@takomo.io |
| Maintainers | henrim, takomo-ci |
| Keywords | aws, cloudformation, cfn, deploy, cli, cloudformation templates, cloudformation stacks, cloudformation deployment |

## Links

- npm: https://www.npmjs.com/package/takomo
- Repository: https://github.com/takomo-io/takomo
- Homepage: https://takomo.io
- Issues: https://github.com/takomo-io/takomo/issues
- npm.io page: https://npm.io/package/takomo

## Dependencies (38)

- [ejs](https://npm.io/package/ejs.md) 6.0.1
- [joi](https://npm.io/package/joi.md) 18.2.9
- [diff](https://npm.io/package/diff.md) 9.0.0
- [uuid](https://npm.io/package/uuid.md) 14.0.2
- [chalk](https://npm.io/package/chalk.md) 6.0.0
- [ramda](https://npm.io/package/ramda.md) 0.32.0
- [yargs](https://npm.io/package/yargs.md) 18.1.0
- [dotenv](https://npm.io/package/dotenv.md) 17.4.2
- [lodash](https://npm.io/package/lodash.md) 4.18.1
- [semver](https://npm.io/package/semver.md) 7.8.5
- [esbuild](https://npm.io/package/esbuild.md) 0.28.2
- [js-yaml](https://npm.io/package/js-yaml.md) 5.4.2
- [p-queue](https://npm.io/package/p-queue.md) 9.3.3
- [jmespath](https://npm.io/package/jmespath.md) 0.16.0
- [readdirp](https://npm.io/package/readdirp.md) 5.1.1
- [cockatiel](https://npm.io/package/cockatiel.md) 4.0.0
- [pretty-ms](https://npm.io/package/pretty-ms.md) 9.3.1
- [ts-dedent](https://npm.io/package/ts-dedent.md) 2.3.0
- [easy-table](https://npm.io/package/easy-table.md) 1.2.0
- [handlebars](https://npm.io/package/handlebars.md) 4.7.9
- [neverthrow](https://npm.io/package/neverthrow.md) 8.2.0
- [folder-hash](https://npm.io/package/folder-hash.md) 4.1.3
- [date-and-time](https://npm.io/package/date-and-time.md) 4.5.2
- [dotenv-expand](https://npm.io/package/dotenv-expand.md) 1000.0.0
- [@aws-sdk/types](https://npm.io/package/@aws-sdk/types.md) 3.974.5
- [@inquirer/prompts](https://npm.io/package/@inquirer/prompts.md) 8.7.2
- [@aws-sdk/client-s3](https://npm.io/package/@aws-sdk/client-s3.md) 3.1132.0
- [@smithy/util-retry](https://npm.io/package/@smithy/util-retry.md) 4.6.2
- [source-map-support](https://npm.io/package/source-map-support.md) 0.5.21
- [@aws-sdk/client-ssm](https://npm.io/package/@aws-sdk/client-ssm.md) 3.1132.0
- [@aws-sdk/client-sts](https://npm.io/package/@aws-sdk/client-sts.md) 3.1132.0
- [json-stable-stringify](https://npm.io/package/json-stable-stringify.md) 1.3.0
- [@smithy/node-http-handler](https://npm.io/package/@smithy/node-http-handler.md) 4.12.1
- [@aws-sdk/client-cloudtrail](https://npm.io/package/@aws-sdk/client-cloudtrail.md) 3.1132.0
- [@aws-sdk/client-organizations](https://npm.io/package/@aws-sdk/client-organizations.md) 3.1132.0
- [@aws-sdk/credential-providers](https://npm.io/package/@aws-sdk/credential-providers.md) 3.1132.0
- [@aws-sdk/client-cloudformation](https://npm.io/package/@aws-sdk/client-cloudformation.md) 3.1132.0
- [@aws-sdk/client-secrets-manager](https://npm.io/package/@aws-sdk/client-secrets-manager.md) 3.1132.0

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 11.1.0 (latest) — 2026-09-26
- 11.0.0-alpha.1 (alpha) — 2026-08-23
- 11.0.2 — 2026-09-25
- 11.0.1 — 2026-09-03
- 11.0.0 — 2026-08-23
- 10.1.0-alpha.4 — 2026-08-23
- 10.1.0-alpha.3 — 2026-08-23
- 10.1.0-alpha.2 — 2026-08-22
- 10.1.0-alpha.1 — 2026-08-17
- 10.0.8 — 2026-07-27
- 10.0.7 — 2026-07-15
- 10.0.6 — 2026-06-15
- 10.0.5 — 2026-05-11
- 10.0.4 — 2026-05-11
- 10.0.3 — 2026-05-04
- … 194 more at https://npm.io/package/takomo/versions

## README

# Takomo

![GitHub](https://img.shields.io/github/license/takomo-io/takomo)
![npm](https://img.shields.io/npm/v/takomo)
![node-current](https://img.shields.io/node/v/takomo)
[![Gitter chat](https://badges.gitter.im/gitterHQ/gitter.svg)](https://gitter.im/takomo-io/community)

Takomo makes it easy to organize, parameterize and deploy your CloudFormation stacks across multiple regions and accounts.

# Quick Start

Let's see how to create a simple CloudFormation stack using Takomo.

## Installation

Install Takomo globally:

    npm i -g takomo

Verify installation:

    tkm --version

## AWS Credentials

You need to have valid AWS credentials configured. Create a profile named `takomo-example` in your `~/.aws/credentials` file:

    [takomo-example]
    aws_access_key_id=XXXXXXXXXXXXXXXXXXXX
    aws_secret_access_key=YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY

## Stack Configuration

Our stack contains a VPC whose CIDR range can be parameterized. First, we need to create a `stacks` directory that will host all stack configurations. Create the directory and add there a file named `vpc.yml` with the following contents:

    regions: eu-west-1
    parameters:
      CidrBlock: 10.0.0.0/24

## Stack Template

Next, we need to provide a CloudFormation template for our stack. Create `templates` directory next to the `stacks` directory, and add there a file named `vpc.yml` with the following contents:

    Description: My VPC
    Parameters:
      CidrBlock:
        Type: String
        Description: VPC CIDR block
    Resources:
      VPC:
        Type: AWS::EC2::VPC
        Properties:
          CidrBlock: !Ref CidrBlock

## Stack Deployment

Alright, we are ready to deploy our stack. Change to the project root directory and run:

    tkm stacks deploy --profile takomo-example

You will be prompted if you want to continue the deployment. You also need to review and approve the changes. If you answer yes to both questions, then the deploy will proceed, and given your AWS credentials had all the needed IAM permissions, it should also succeed.

## Clean Up

You can delete the stack with command:

    tkm stacks undeploy --profile takomo-example

## Next Steps

Take a look at https://takomo.io for more documentation.

---
_Source: https://npm.io/package/takomo · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
