Create Your First App Template

Use an example app template to learn Nuon or package your product as a Nuon app template.

Your first app template can take one of two forms, and both install into your cloud account:

• An example app (recommended): the fastest way to see Nuon work end to end. Use one of our pre-built example apps.
• Your own app template: your product packaged in Nuon’s configuration format, referencing your existing Terraform, Helm, Kubernetes, and Docker assets.

New to Nuon? Read the App & Install Life Cycle guide to understand how apps are packaged, installed and managed with Nuon.

Use an Example App

Each guide below deploys a working example into your AWS account:

• eks-simple: An AWS EKS (Kubernetes) Traefik whoami application (~35 min)
• cde: An AWS EC2 VM you connect to with ssh and VS Code Web (~26 min)
• aws-lambda: A Lambda function with DynamoDB and API Gateway (~26 min)

Estimated times above include creating the initial VPC, Subnets, Nat Gateway, ASG, EC2 VM, and a healthy Nuon runner (~11 min). For the fastest duration, approve all workflow steps when the app install begins.

cde and aws-lambda are less resource and cost intensive than eks-simple which provisions a Kubernetes cluster with 3 nodes.

For these and other examples, clone the example-app-configs repository. Each example ships through an app branch. If the example’s directory has no branch file (branch.toml or branches/main.toml), add branches/main.toml:

branches/main.toml

name = "main"

[public_repo]
repo      = "nuonco/example-app-configs"
directory = "<app directory>"
branch    = "main"

Then run:

brew install nuonco/tap/nuon
nuon auth login
cd example-app-configs/<app directory>
nuon apps create --name <app directory>
nuon branches sync --file branches/main.toml   # or: --file branch.toml; starts the first run
nuon installs create --name <install-name> --region <region>

Use Your Own App

When you’re ready to try your product with Nuon, package your existing Terraform, Helm, Kubernetes manifest, and container image assets into a Nuon app template, then install it into your AWS, Azure or GCP.

See how apps are configured to structure your app, including connecting a GitHub repository.

Use agents like Claude Code to build your app template by learning from Nuon’s example apps. See our AI and App Template Building docs for more info.

Prerequisites

• Sign up for the free trial. You’ll get a login and an org in Nuon Cloud.
• The example apps above need an AWS account to install into. Set up an AWS account if you don’t have one. Nuon also has apps for Azure and GCP in our example apps repo.