Comece em 5 minutos

Do zero a uma API serverless validada e pronta pra deploy. Você só precisa de Node.js 20+.

1. Instale

npm install -g iacmp

Confira se funcionou:

iacmp --version

Comando não encontrado?

O instalador cria um atalho do iacmp no seu PATH para uso imediato. Se o shell ainda não encontrar, abra um novo terminal. Ainda nada? Diagnostique com:

npx iacmp doctor

2. Crie um projeto

iacmp init minha-api --template serverless
cd minha-api

Isso gera um projeto completo e funcional:

minha-api/
  iacmp.json          # provider, região, linguagem
  stacks/             # sua infraestrutura, uma stack por domínio
  src/handlers/       # handlers TypeScript (agnósticos de nuvem)
  CLAUDE.md           # guia agentes de IA pelo fluxo certo

Quer ver os outros templates (blank, hello, rds, webapp, network, serverless, fullstack)?

iacmp init --list

3. Veja o que você ganhou

Uma stack é TypeScript puro — sem YAML, sem HCL:

import { Stack, Fn, Database, ref } from '@iacmp/core';

const stack = new Stack('ApiStack');

new Database.DynamoDB(stack, 'ItemsTable', { partitionKey: 'id' });

new Fn.Lambda(stack, 'ItemsFn', {
  runtime: 'nodejs20',
  handler: 'index.handler',
  code: 'dist/handlers/items',
  environment: { TABLE_NAME: ref('ItemsTable', 'Name') },
});

export default stack;

Os handlers usam a fachada agnóstica @iacmp/runtime — o mesmo código roda em Lambda, Azure Functions e Cloud Functions:

import { table } from '@iacmp/runtime';

export async function handler() {
  const items = await table('ItemsTable').scan();
  return { statusCode: 200, body: JSON.stringify(items) };
}

4. Sintetize

iacmp synth

Isso compila suas stacks para o formato nativo do provider configurado (CloudFormation por padrão) e valida — tanto com as checagens semânticas do próprio iacmp quanto com o validador da nuvem, quando o CLI dela está configurado:

✔ ApiStack → out/aws/api-stack.json
  CFN validate OK: api-stack

Experimente as outras nuvens a partir do mesmo código:

iacmp synth --provider azure    # → Bicep
iacmp synth --provider gcp      # → Terraform (tf.json)

5. Faça o deploy (opcional, mas é a parte boa)

Você precisa do CLI da nuvem-alvo configurado. Nunca usou nuvem? Siga Contas de nuvem e CLIs — do zero da conta até a autenticação, passo a passo. Já tem conta na AWS? Então é só:

aws configure        # access key, secret, região
iacmp doctor         # confere se está tudo no lugar

Depois:

iacmp deploy --dry-run --provider aws   # mostra exatamente o que seria criado
iacmp deploy --provider aws             # deploy de verdade (pede confirmação)

Sem --provider, o iacmp usa o que está no iacmp.json do projeto (aws, azure ou gcp).

Quando terminar de experimentar:

iacmp destroy --provider aws            # remove tudo (pede confirmação)

6. Explore

iacmp diagram             # diagrama C4 da arquitetura a partir das stacks
iacmp audit-all           # auditorias de segurança, alta disponibilidade e DR
iacmp diff                # o que mudaria no próximo deploy

Idioma

O CLI fala inglês (padrão) e português:

IACMP_LANG=pt iacmp synth      # pontual
export IACMP_LANG=pt           # de vez, no perfil do seu shell

Próximo passo

Deixe um agente de IA escrever por você: use o iacmp com Claude Code.