CLI

Set up and deploy your first Ember with kiln, the Emberline command-line tool.

This guide walks you through creating a project, running it locally and deploying it to the network.

Prerequisites

1. Sign up for an Emberline account.

2. Install Node.js 18 or later.

1. Create a new project

Open a terminal and run the project generator. create-ember scaffolds a project with a configuration file, a sample handler and the CLI installed locally.

npm create ember@latest -- my-first-ember

yarn create ember my-first-ember

pnpm create ember@latest my-first-ember

Choose these options when prompted:

• For What would you like to start with?, choose Hello World.

• For Which language do you want to use?, choose TypeScript.

• For Do you want to use git?, choose Yes.

• For Do you want to deploy now?, choose No (you will deploy at the end).

Then move into the new folder:

cd my-first-ember

2. Develop locally

Start a local server that runs your Ember in the same runtime the network uses:

npx kiln dev

The first time you run kiln, it opens a browser window so you can sign in. Visit http://localhost:8788 to see your Ember.

3. Write code

Open src/index.ts. It exports a default object with a fetch handler:

export default {
  async fetch(request: Request, env: Env, ctx: ExecutionContext) {
    return new Response("Hello from the edge!");
  },
};

Change the response text and save:

export default {  async fetch(request: Request, env: Env, ctx: ExecutionContext) {    return new Response("Hello, Emberline!");  },};

4. Deploy your project

Deploy to a free *.ember.dev subdomain or a domain you own:

npx kiln deploy

If you have not chosen a subdomain yet, kiln asks for one before publishing.

Next steps

• Connect a repository so every push deploys automatically.

• Add a binding to store data in Cinder KV.

• Browse the examples for common patterns.

• Read about limits and pricing.