Hello World

Encore lets you easily define type-safe, idiomatic TypeScript API endpoints. It's done in a fully declarative way, enabling Encore to automatically parse and validate the incoming request and ensure it matches the schema, with zero boilerplate.

To define an API, use the api function from the encore.dev/api module to wrap a regular TypeScript async function that receives the request data as input and returns response data. This tells Encore that the function is an API endpoint. Encore will then automatically generate the necessary boilerplate at compile-time.

This means you need less than 10 lines of code to define a production-ready deployable service and API endpoint:

import { api } from "encore.dev/api";

export const get = api(
  { expose: true, method: "GET", path: "/hello/:name" },
  async ({ name }: { name: string }): Promise<Response> => {
    const msg = `Hello ${name}!`;
    return { message: msg };
  }
);

interface Response {
  message: string;
}

Getting started video

Get to know the basics of Encore.ts in this getting started video.

Using databases, Pub/Sub, and other primitives

Encore's Backend Framework makes it simple to add more primitives, such as additional microservices, databases, Pub/Sub, etc. See how to use each primitive:

• Services
• APIs
• Databases
• Cron Jobs
• Pub/Sub & Queues
• Secrets