Fjall Docs — Deploy Production-Ready AWS Infrastructure in Minutes

fjall add edits an application’s infrastructure.ts through the codemod engine. It does not deploy. Run fjall deploy afterwards to apply changes to AWS.

Overview

fjall add appends a resource to an existing application’s infrastructure.ts. It writes valid CDK code, wires connections to existing resources, and reports the lines changed. The command runs the codemod engine directly in both human and agent modes. There is no interactive resource picker on this path.

Usage

fjall add <type> --app <app> --name <Name> [--<property> <value> ...]

Token	Meaning
`<type>`	Required. The resource category (see Resource Types).
`--app <app>`	Required. The application to edit.
`--name <Name>`	Required. Resource name in PascalCase.
`[--<property> <value> ...]`	Optional. Resource-specific configuration as repeated `--<name> <value>` pairs.

Resource Types

<type> is one of these exact values:

Type	Adds
`database`	A managed database (Aurora, RDS instance, GlobalAurora, ClickHouse, or DynamoDB).
`compute`	A compute service (Lambda, ECS, or EC2).
`storage`	An S3 bucket.
`cdn`	A CloudFront distribution.
`messaging`	An SQS queue or SNS topic.
`network`	A network resource.
`pattern`	A higher-level pattern composition.
`vpc-peer`	A VPC peering requester.
`vpc-peer-accepter`	A VPC peering accepter.
`cross-plan-connection`	A connection to a resource in another application.

There is no proxy or service type, and there is no colon syntax. A database variant, RDS proxy, or additional ECS service is configured with property flags, not a separate type. fjall add database:Aurora is invalid.

Property flags

Every flag after --app, --name, --verbose, and --non-interactive is a resource property, parsed as a --<name> <value> pair. Three rules apply:

Each flag consumes the next token as its value. A trailing flag with no value is rejected.
A flag immediately followed by another --flag is rejected (no value-less booleans). Pass an explicit value such as --require-tls true.
Duplicate flags are rejected so typos surface instead of being silently overwritten.

Examples

Add a database

database is always the type. Choose the variant with the --type property (Aurora, Instance, GlobalAurora, ClickHouse, or DynamoDB):

fjall add database --app api --name Analytics --type Aurora
fjall add database --app api --name Sessions --type Instance

The codemod emits DatabaseFactory.build("Analytics", { type: "Aurora", ... }).

Add a compute service

# Lambda function
fjall add compute --app api --name OrderProcessor --type lambda

# ECS service on Fargate Spot for cost savings
fjall add compute --app api --name Worker --type ecs --capacity-provider FARGATE_SPOT

Add a storage bucket

fjall add storage --app api --name Uploads

Add a CDN distribution

fjall add cdn --app web --name Assets

Restore a database from a snapshot

Pass the snapshot details as property flags. The master username is baked into the snapshot:

fjall add database --app api --name Restored --type Instance \
  --snapshot-identifier rds:my-production-snapshot \
  --snapshot-username postgres

The master username is immutable and baked into the snapshot. It must match the original database’s username exactly.

Add an RDS proxy

A proxy is a property of a database resource, configured with property flags such as --proxy and --max-connections:

fjall add database --app api --name Sessions --type Instance \
  --proxy true \
  --max-connections 50 \
  --require-tls true

Options

These are the only flags the add command registers. Everything else is a property flag.

Option	Description
`-a, --app <name>`	Application to add the resource to (required).
`-n, --name <name>`	Resource name in PascalCase (required).
`-v, --verbose`	Enable verbose logging.
`--non-interactive`	Force plain CLI output (no UI).

Agent options

For AI-agent and scripted use, add also accepts the standard agent flags:

Option	Description
`--agent`	Emit machine-readable agent output.
`--budget <level>`	Output verbosity budget for agent mode.
`--fields <fields>`	Restrict the output to named fields.
`--full`	Include the full result payload.

Non-Interactive Mode

For CI/CD pipelines, pass --non-interactive with all required flags so no prompt is reached:

# Aurora database
fjall add database --app api --name Analytics --type Aurora --non-interactive

# Lambda function
fjall add compute --app api --name Worker --type lambda --non-interactive

# ECS service on Fargate Spot
fjall add compute --app api --name Api --type ecs \
  --capacity-provider FARGATE_SPOT --non-interactive

Connection Management

When adding a resource, Fjall detects existing resources, configures security groups, and sets environment variables on connected compute. Connected resources receive automatic environment variables:

# First database connection
DATABASE_HOST=app-db.cluster-xxx.amazonaws.com
DATABASE_PORT=35255
DATABASE_NAME=AppDatabase
DATABASE_PASSWORD=<from-secrets-manager>

# Additional database connections
DATABASE_HOST_1=analytics-db.cluster-xxx.amazonaws.com
DATABASE_PORT_1=35255
DATABASE_NAME_1=AnalyticsDB
DATABASE_PASSWORD_1=<from-secrets-manager>

Add Multiple Resources

Chain commands for a multi-resource setup:

fjall add database --app api --name Analytics --type Aurora
fjall add compute --app api --name Worker --type lambda
fjall add compute --app api --name Api --type ecs

Resource Naming

Resource names are PascalCase and must be unique within the application. Pick descriptive names such as Analytics, Sessions, or Uploads so resources are easy to identify later. If a name conflicts with an existing resource, the codemod reports the conflict instead of overwriting.

After Adding a Resource

Review the modified infrastructure.ts.
List the application’s resources to confirm the change: fjall list --app api.
Deploy to apply the change to AWS: fjall deploy api.

Next Steps

fjall deploy

Apply the new resource to AWS.

fjall list

List the resources in an application’s infrastructure.ts.

fjall create

Create a new application before adding resources to it.

fjall secrets

Manage application secrets in AWS.

Core Commands

Infrastructure Codemods

Management Commands

Authentication

Agent Mode

fjall add

Overview

Usage

Resource Types

Property flags

Examples

Add a database

Add a compute service

Add a storage bucket

Add a CDN distribution

Restore a database from a snapshot

Add an RDS proxy

Options

Agent options

Non-Interactive Mode

Connection Management

Add Multiple Resources

Resource Naming

After Adding a Resource

Next Steps

fjall deploy

fjall list

fjall create

fjall secrets

​Overview

​Usage

​Resource Types

​Property flags

​Examples

​Add a database

​Add a compute service

​Add a storage bucket

​Add a CDN distribution

​Restore a database from a snapshot

​Add an RDS proxy

​Options

​Agent options

​Non-Interactive Mode

​Connection Management

​Add Multiple Resources

​Resource Naming

​After Adding a Resource

​Next Steps

fjall deploy

fjall list

fjall create

fjall secrets

Overview

Usage

Resource Types

Property flags

Examples

Add a database

Add a compute service

Add a storage bucket

Add a CDN distribution

Restore a database from a snapshot

Add an RDS proxy

Options

Agent options

Non-Interactive Mode

Connection Management

Add Multiple Resources

Resource Naming

After Adding a Resource

Next Steps