Skip to main content
Read-only command. Lists the resources declared in an application’s infrastructure.ts. It does not query AWS or change anything.

​
Overview

fjall list reads an application’s infrastructure.ts and prints every resource the codemod engine manages: databases, storage, compute, and the rest. Use it to confirm what a fjall add or fjall remove left behind before you deploy. For an organisation or application overview, use fjall apps (lists applications) or fjall status (shows deployment status). fjall list works on a single application’s resource declarations only.

​
Prerequisites

  • An application created with fjall create app, so an infrastructure.ts file exists.
  • Run the command from your project root (where the fjall/ directory lives).

​
Usage

The --app flag is required. The optional [type] positional filters the output to one resource type.

​
Options

​
Resource types for [type]

​
Examples

​
List every resource

Output:
The header shows the application name and the resource count. Each row lists the resource name, its type, and the file it lives in.

​
Filter by type

Pass a resource type to narrow the output:
Output:

​
JSON output

For scripts and tooling, emit the resource list as JSON:

​
Empty application

A newly created application with no added resources prints a zero count:

​
How it works

  1. Resolves the infrastructure.ts path for the application you pass to --app.
  2. Parses the file with the codemod engine (an AST parser, no AWS calls).
  3. Collects every managed resource declaration.
  4. Applies the [type] filter if you passed one.
  5. Prints the result as a table, or as JSON with --json.
The command reads local files only. It never contacts AWS and never reports deployment status.

​
Common workflows

​
Confirm an added resource

​
Confirm a removed resource

fjall remove deletes a resource from infrastructure.ts. List afterwards to verify the file no longer declares it:

​
Inspect before deploying

​
Troubleshooting

​
”Application is required”

The --app flag is mandatory. Pass the application name:

​
Resource missing from the list

If a resource you expected does not appear:
  • Confirm you passed the right application to --app.
  • Check the [type] filter is not hiding it. Run fjall list --app api with no type to see everything.
  • Verify the resource was added to infrastructure.ts (re-run fjall add if needed).
fjall list reflects only what is declared in infrastructure.ts. To check what is actually deployed to AWS, use fjall status.

​
Next Steps

fjall add

Add a resource to an application’s infrastructure.

fjall create

Create an application with its infrastructure.ts file.

fjall deploy

Deploy an application’s infrastructure to AWS.

fjall destroy

Tear down deployed infrastructure for a target.