Skip to content

Releases: encoredev/encore

Launch Week Release Roundup

13 May 12:56
@marcuskohlberg marcuskohlberg
v1.37.0
e859482
Compare
Choose a tag to compare
Launch Week Release Roundup

Launch Week

Last week was Encore's first ever Launch Week, 5 days of big releases and community events.

It was pretty hectic, with plenty of cool new features. Here's everything that was launched.
You can also find blogs, videos, and livestream recording for all the launches on the Launch Week website.

Day 1: Encore for TypeScript

Encore now supports TypeScript and it's generally available! The new Open Source Backend SDK provides a declarative way of building services, APIs, and using cloud primitives like databases, Pub/Sub, cron jobs, and more.

Encore for TypeScript is powered by our new Rust-based runtime, integrated with Node.js for 100% compatability the Node ecosystem.
It provides some major upgrades compared to standard Node.js/Express:

  • 7x faster throughput (req/s)
  • 85% reduced response latency
  • 0 NPM dependencies
  • End-to-end type-safety even at runtime

📚 See the launch announcement on the blog
🎥 Watch the launch video on YouTube

Day 2: Encore is fully Open Source + New lower price plan

Encore's Open Source tools and SDKs can now be used fully independent of Encore, and requires no Encore account! This means you can more easily build and self-host Encore applications with no dependency on Encore the organization.

We've also made these improvements:

  • Simplified configuration for self-hosting Encore apps and improved documentation.
  • The Free plan now gets unlimited seats.
  • New Pro plan at a much lower price, just $39 per member / month. (See more info on pricing)

📚 See the launch announcement on the blog

Day 3: Serverless Postgres & Database branching powered by Neon

Encore now supports using Neon as a database provider for all your environments, including those in your cloud on AWS and GCP. Neon's serverless postgres scales to zero, which makes it a great choice for early stage startups who may want to optimize their cloud costs.

When you use Neon for your production or testing database, you can configure Encore's built-in ephemeral Preview Environments to branch off this database, automatically seeding your Preview Environment with real-world data to simplify testing.

📚 See the launch announcement on the blog
🎥 Watch the launch video on YouTube

Day 4: Elevate with Encore & Ardan Labs

Ardan Labs is now Encore's official Go training partner, and to celebrate we're launching a program designed to help you enhance your skills and increase your visibility within the developer community.

You get discounts on Go training from the experts at Ardan Labs, and Encore provides coaching and financial support to help you speak at tech conferences.

📚 See the launch announcement on the blog
🎥 Watch the launch video on YouTube

Day 5: AI API Creator

For the final day of Launch Week, we introduced Encore's first AI powered feature: AI API Creator, helping you speed up your development by turning prompts into production-ready code!

Integrated into Encore's local development dashboard, the new API Creator helps you quickly design and create new services and APIs, then add them directly to your app. All without leaving the dashboard.

Unlike most other AI tools, Encore's AI API Creator has a purpose-built workflow that gives you much more control over the API design and allows for simple and fast manual edits, without requiring endless prompting.

📚 See the launch announcement on the blog
🎥 Watch the launch video on YouTube

Launch Week will return

That's it for this time, we hope you enjoyed the show and will find these new launches helpful for your development! If you have any questions, feedback, or just want to hang out with other developers, join our friendly community on Discord.🖤

— André & the Encore team

Detailed changelog

Full Changelog: v1.35.3...v1.37.0

Contributors

eandre, simon-johansson, and 4 other contributors
Assets 2
Loading
0 Join discussion

TypeScript Metadata API

12 Apr 14:58
@marcuskohlberg marcuskohlberg
v1.35.3
e104f33
Compare
Choose a tag to compare
TypeScript Metadata API

We're excited to announce Encore v1.35, with several improvements to Encore for TypeScript!

Discord

We've also just moved the Encore Community to Discord. This gives us several key features that we believe will make the community more engaging and helpful for all members:

  • This will give us several key features that we believe will make the community more engaging and helpful for all members:
  • Unlimited message history, so we never lose valuable chats.
  • Improved Q&A using built-in forums, making it faster and easier to find answers and share knowledge.
  • Dedicated boards for submitting and voting on suggestions — we love hearing your ideas and want to get better at tracking them.
  • The ability to schedule and host live streamed community events.

Hope to see you there!

TypeScript Metadata API

We've added a new API for querying metadata about the application's running environment. It looks like this:

import { appMeta } from "encore.dev";

const meta = appMeta();

The metadata object contains tons of information about the application and where it's running:

// Describes the running Encore application.
export interface AppMeta {
  // The Encore application ID. If the application is not linked to the Encore platform this will be an empty string.
  // To link to the Encore platform run `encore app link` from your terminal in the root directory of the Encore app.
  appID: string;

  // The base URL which can be used to call the API of this running application.
  //
  // For local development it is "http://localhost:<port>", typically "http://localhost:4000".
  //
  // If a custom domain is used for this environment it is returned here, but note that
  // changes only take effect at the time of deployment while custom domains can be updated at any time.
  apiBaseURL: string;

  // Information about the environment the app is running in.
  environment: EnvironmentMeta;

  // Information about the build.
  build: BuildMeta;

  // Information about the deployment.
  deploy: DeployMeta;
}

// Describes the environment the Encore application is running in.
export interface EnvironmentMeta {
  // The name of environment that this application.
  // For local development it is "local".
  name: string;

  // The type of environment is this application running in.
  // For local development it is "development".
  type: EnvironmentType;

  // The cloud this is running in.
  // For local development it is "local".
  cloud: CloudProvider;
}

// Describes what type of environment the application is running in.
export type EnvironmentType =
  // A production environment.
  | "production"
  // A long-lived cloud-hosted, non-production environment, such as test environments, or local development.
  | "development"
  // A short-lived cloud-hosted, non-production environments, such as preview environments
  | "ephemeral"
  // When running automated tests.
  | "test";

// Describes what cloud provider the application is running in.
export type CloudProvider =
  | "aws" // Amazon Web Services
  | "gcp" // Google Cloud Platform
  | "azure" // Microsoft Azure
  | "encore" // Encore Cloud.
  | "local"; // Local development

// Information about the build that formed the running application.
export interface BuildMeta {
  // The git commit that formed the base of this build.
  revision: string;

  // Whether there were uncommitted changes on top of the commit.
  uncommittedChanges: boolean;
}

// Information about the deployment of the running application.
export interface DeployMeta {
  // The unique id of the deployment. Generated by the Encore Platform.
  id: string;
}

Client Generation improvements

The encore gen client command now accepts --excluded-services=foo,bar to exclude specific services from the generated client.

Various TypeScript Improvements

We're also making rapid improvements to all aspects of Encore for TypeScript:

  • Pub/Sub: Added support for AWS Pub/Sub (SQS + SNS)
  • Pub/Sub: Implemented support for maxConcurrency across local development, GCP, and AWS
  • API: Added trailing slash redirect handling

Full Changelog: v1.34.7...v1.35.3

Assets 2
Loading

Encore for TypeScript Public Beta + Terraform Provider

28 Mar 15:46
@eandre eandre
v1.34.7
d6ea14e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
Encore for TypeScript Public Beta + Terraform Provider

encore for typescript

It's been a long time coming, but just in time for Easter it's finally here: Encore for TypeScript is now in Public Beta!

We're soon going to publish an blogpost with details on the design and architecture, but until then here are the key things to know:

  • We've built a custom TypeScript runtime in Rust, for truly eye-watering performance! We believe Encore based apps will be some of the most high-performance TypeScript apps around.
  • The TypeScript SDK is officially unstable, but we expect most of the remaining work to be additive (not modifying) and it's unlikely there will be breaking changes.
  • The TypeScript Beta already supports most of the Encore features you know and love: the local dev dashboard, API docs, tracing, etc.
  • We are working toward feature parity with the Go version and expect to get there in the coming weeks. Currently there are a few key features remaining to implement: Caching, Middleware, Configuration, Raw endpoints, and Metadata.

Try it out yourself: Update the CLI encore version update, create a new app encore app create, and select TypeScript. 🚀

Share your feedback and bug reports: We're dependent on your feedback to improve Encore, please share your thoughts either by creating an issue here on GitHub or by posting on Slack. ❤️

Introducing: The Encore Terraform Provider

We regularly hear how Encore's approach to infrastructure automation is incredible — for the infrastructure primitives that Encore supports. This is sufficient for the majority of use cases, but when you have a use case that requires additional cloud infrastructure that Encore doesn't (yet) have built-in support for, the experience left something to be desired. To be more specific, since Encore set up the infrastructure automatically it was painful and laborious to reference those resources from Terraform, and required lots of manual work.

To solve that problem we've just released the Encore Terraform Provider that dramatically simplifies the experience of combining Encore-managed cloud infrastructure with additional infrastructure managed by Terraform.

It works by providing Terraform Data Sources for Encore-managed infrastructure resources. The data sources released so far include:

These data sources make it easy to retrieve information about the underlying cloud infrastructure that Encore has provisioned, making it that much easier to combine Encore-managed infrastructure with additional infrastructure for when you need it.

For more information on how to use the Encore Terraform Provider, check out the docs!

Thanks to all contributors

🙏 We continue to be overwhelmed by your support, feedback, and suggestions!
Together we're building the future of backend development and we couldn't be more excited.

❤️ As always, we're excited to hear what you think!
Please share your feedback on Discord.

New Contributors 🙌

Full Changelog: v1.31.0...v1.34.7

Contributors

aranw, aarongreenlee, and 5 other contributors
Assets 2
Loading
0 Join discussion

Introducing: Test Tracing

25 Jan 16:35
@DomBlack DomBlack
v1.31.0
a5c9c8c
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.
Compare
Choose a tag to compare
Introducing: Test Tracing

We're very excited to announce something the world's never seen before (probably): Test Tracing!

With Encore v1.31.0, encore test now automatically captures a trace of every test, providing much more visibility into what's happening and making it easier to understand why a test failed.

The test traces automatically include everything you expect from Encore's automatic tracing:

  • API calls (including mocked calls with Encore's new mocking support!).
  • Database queries
  • Pub/Sub messages
  • HTTP requests
  • ... and so on

And best of all: it works with all your existing tests.

Upgrade to Encore v1.31 to try it out: encore version update

image

image

✨ Local Development Dashboard Enhancements

We've made several quality-of-life improvements to the local development dashboard. These enhancements include the ability to view all Encore apps via the local dashboard, regardless of whether they are currently running or not. We've also made several UI improvements to the dashboard, including displaying request logs when an API call is made, notifications when the app is compiling, and notifications when the app has just restarted.

📆 Roadmap

We're currently pushing to get TypeScript support out the door and hope to release the first general availability in the next few weeks. We've also been working on some smaller features based on your comments on Slack which will drop in the next few days: cloud cost insights and the ability to pause and trigger cron jobs from the Cloud Dashboard.

Check out the roadmap and leave your comments!

Thanks to all contributors

🙏 We continue to be overwhelmed by your support, feedback, and suggestions!
Together we're building the future of backend development and we couldn't be more excited.

❤️ As always, we're excited to hear what you think!
Please share your feedback on Discord.

Full Changelog: v1.30.0...v1.31.0

Assets 2
Loading
0 Join discussion

Mock it till you drop it: API and Service mocking support is here

22 Jan 15:49
@marcuskohlberg marcuskohlberg
v1.30.0
6f56db4
Compare
Choose a tag to compare
Mock it till you drop it: API and Service mocking support is here

With v1.30.0 we're now introducing support for mocking APIs and services! This makes it much simpler to test your application in isolation.

Let's look at an example:

You have an endpoint that calls an external API in our products service:

//encore:api private
func GetPrice(ctx context.Context, p *PriceParams) (*PriceResponse, error) {
    // Call external API to get the price
}

When testing this function, you don't want to call the real external API since that would be slow and cause your tests to fail if the API is down. Instead, you want to mock out the API call and return a fake response.

You can now do this in Encore by adding a mock implementation of the endpoint using the et.MockEndpoint function inside your test:

package shoppingcart

import (
	"context"
	"testing"
	
	"encore.dev/et" // Encore's test support package
	
	"your_app/products"
)


func Test_Something(t *testing.T) {
	t.Parallel() // Run this test in parallel with other tests without the mock implementation interfering
	
	// Create a mock implementation of pricing API which will only impact this test and any sub-tests
	et.MockEndpoint(products.GetPrice, func(ctx context.Context, p *products.PriceParams) (*products.PriceResponse, error) {
		return &products.PriceResponse{Price: 100}, nil
	})
	
	// ... the rest of your test code here ...
}

In addition to mocking individual APIs, you can also mock entire services. This can be useful if you want to inject a different set of dependencies into your service for testing, or a service that your code depends on.

When mocking services, Encore will automatically generate an Interface interface for every service, which contains all the APIs defined in the service. This makes it possible to automatically generate mock objects for your services using either Mockery or GoMock.

📚 Check out the docs for all the details.

👉 Remember to update using: encore version update and go get encore.dev@latest

Improved docs search

We've updated the docs search functionality to make it easier to find what you're looking for. Search now has improved relevancy, snippets are much improved, and results can now link directly to sub-sections of individual pages.

Roadmap

We're currently pushing to get TypeScript support out the door and hope to release the first general availability in the next few weeks.
We've also been working on some smaller features based on your comments on Slack which will drop in the next few days: cloud cost insights and the ability to pause and trigger cron jobs from the Cloud Dashboard.

Check out the roadmap and leave your comments!

Thanks to all contributors

🙏 We continue to be overwhelmed by your support, feedback, and suggestions!
Together we're building the future of backend development and we couldn't be more excited.

❤️ As always, we're excited to hear what you think!
Please share your feedback on Discord.

Full Changelog: v1.29.7...v1.30.0

Assets 2
Loading
0 Join discussion

TypeScript (and winter) is coming!

07 Dec 13:47
@eandre eandre
v1.29.2
d06bb0a
Compare
Choose a tag to compare
TypeScript (and winter) is coming!

Encore v1.29 is out with a whole bunch of quality-of-life improvements and bugfixes.

As always, get the latest version with encore version update!

TypeScript update

We're making rapid progress on Encore's TypeScript support, and plan to have an initial release out in the coming weeks. In the meantime, join us on Slack and let us know if you're interested in participating in the private beta.

API Schema Validation & Autocomplete

Encore now validates and autocompletes request payloads via the API Explorer and Service Catalog! Check it out in action:

autocomplete.mov

Streaming Traces

Encore now streams traces to the Encore Platform as they're happening, instead of waiting for the request to complete. This dramatically improves trace ingestion latency and reduces the memory usage of Encore applications. The new functionality is automatically enabled, starting with your next deploy. (See #944 and #976)

Go Workspaces

Encore now supports Go workspaces! This enables more seamless development of multi-module applications. (See #975)

CORS Improvements

Encore's CORS handling now automatically allows User-Agent to be allowed for incoming requests. (See #956)

Deleted environment handling

The Encore Platform now supports viewing environments that have been deleted. This is particularly useful for Preview Environments since they're automatically deleted on PR merge.

Shadow Databases

Encore now supports creating "shadow databases" for use with tools like Atlas and Prisma Migrate. A shadow database is an empty database that can be used by migration tools to compare the current state with the desired state.

Encore supports using shadow databases with the encore db commands you already know by passing in the --shadow flag. For example, encore db reset --shadow --all resets all shadow databases back to their empty state, while encore db conn-uri --shadow provides a connection string for use in tools like Atlas and Prisma Migrate.

We've updated the docs to use this functionality for a better integration with Atlas.

(See #949)

Bugfixes

Beyond this, a whole slew of bugfixes and other improvements:

  • Fixed initialization race in metrics (#978)
  • Fixed new traces incorrectly appearing in the local developer dashboard when running multiple applications (#960)
  • Fixed metrics collection on startup and shutdown (#953)
  • Fixed duplicate trace spans for stdlib queries (#952)
  • Fixed error reporting when having multiple migrations with the same migration number (#945)
  • Improved graceful pod termination when running in Kubernetes (#938)
  • Added support for having an empty migration directory (#936)
  • Fixed code rewriting edge case with a file containing nothing but "package " (#979)
  • Members are now correctly allowed to manually trigger deployments
  • Links to code viewer now work correctly with a custom app root directory
  • Fixed trace replay pane scrolling
  • Improved Connect Cloud documentation and copy to make it clearer
  • Infrastructure Edit panel for Cloud Run now supports setting min==max

Thanks to all contributors

🙏 We continue to be overwhelmed by your support, feedback, and suggestions!
Together we're building the future of backend development and we couldn't be more excited.

❤️ As always, we're excited to hear what you think!
Please share your feedback on Discord.

Full Changelog: v1.28.0...v1.29.2

Assets 2
Loading
0 Join discussion

AWS Kubernetes Support + Command Menu

27 Oct 12:16
@marcuskohlberg marcuskohlberg
v1.28.0
306c98d
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
AWS Kubernetes Support + Command Menu

Amazon EKS Support

We're happy to share that Encore now supports deploying to Amazon Elastic Kubernetes Service (EKS)! 🎉
This also means you can now deploy your app to Kubernetes on both GCP and AWS.

Encore uses EKS AWS Fargate (which is a very confusing name — Thanks Amazon!) to run your Kubernetes applications using serverless compute. This removes the need to provision and manage servers, lets you specify and pay for resources per application, and improves security through application isolation by design.

To deploy your app to EKS: Go to Create Environment, select Amazon Web Services as the cloud, then select Kubernetes: EKS Fargate.

aws eks

Command Menu

As we add more and more features to Encore, we also want to make navigation simpler and faster. We're now introducing the Command Menu as a new lightning-fast method of moving around the Cloud Dashboard (coming soon to Local Dev Dash!).⚡️

Try it out yourself by opening your app in the Cloud Dashboard and pressing ⌘+K (Mac) or Ctrl+K!

In this first release, Command Menu lets you search for pages in the Cloud Dashboard and Docs. Soon we'll add much more functionality, like the ability to search for apps, services, endpoints, and more.

We'd love to hear your feedback and ideas for how to improve it — jump on Slack and share your thoughts!

commandmenu.mp4

Thanks to all contributors

🙏 We continue to be overwhelmed by your support, feedback, and suggestions!
Together we're building the future of backend development and we couldn't be more excited.

❤️ As always, we're excited to hear what you think!
Please share your feedback on Slack.

Full Changelog: v1.27.7...v1.28.0

Assets 2
Loading
2 Join discussion

Local Dev Dash 2.0 and kubectl Support

27 Sep 15:22
@marcuskohlberg marcuskohlberg
v1.27.0
2a2878c
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
Local Dev Dash 2.0 and kubectl Support

Local Dev Dash 2.0

🎉 We're happy to share that the Local Dev Dash has received a big upgrade!

The main improvement is in the API explorer. It now features multiple tabs so you can work on multiple endpoints more easily, and lets you store and re-use custom requests. You can now also share these with your team members to create your own internal repository of often-used requests.

We hope these improvements will make your local development workflow smoother and faster than ever before!

Ready to try it out?
👉 Remember to update your CLI first: encore version update

localdashnew.mp4

kubectl Support

Kubernetes provides the command line tool kubectl for communicating with a Kubernetes cluster's control plane, using the Kubernetes API.

If your Encore application has environments using Kubernetes, application Admins can now configure your local kubectl to access your cluster automatically, without needing to fuss with IP allow lists, port forwarding, or firewall rules.

From your application directory, run encore kubernetes configure -env=[ENV_NAME]. Then you can immediately run kubectl get deployments or your next favourite kubectl command.

👉 Remember to update your CLI: encore version update

Thanks to all contributors

🙏 We continue to be overwhelmed by your support, feedback, and suggestions!
Together we're building the future of backend development and we couldn't be more excited.

❤️ As always, we're excited to hear what you think!
Please share your feedback on Slack.

Full Changelog: v1.26.0...v1.27.0

Assets 2
Loading
0 Join discussion

Neon Databases for Preview Environments + Open in Editor

19 Sep 10:13
@marcuskohlberg marcuskohlberg
v1.26.0
99069d9
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
Neon Databases for Preview Environments + Open in Editor

Neon Databases for Preview Environments

As a first step toward full support for Neon SQL databases, we've updated Preview Environments to now provision databases using Neon. The only noticeable impact for your application is that Preview Environments are now faster to provision and start-up.

Soon we'll add support for configuring which type of database you want to use in each environment so that you can take advantage of Neon's scalable, and cost-efficient, SQL offering for all your environments.

Jump straight to your IDE from API explorer

In this release, we've rolled out a quality-of-life feature that's a real boost for your development workflow: the Open in Editor functionality.

This new feature is integrated into the local dev dashboard API explorer. It lets you jump directly to your code editor — and even better — to the exact line of code where the currently selected API endpoint is defined.

No more manual searching, no more juggling between windows. With a single click, you'll be taken straight to the relevant piece of code, so you can get right back to coding.

Have multiple editors installed? No problem! You can easily configure which code editor you'd like to use as your default.

We hope this small feature will improve your development experience starting today!

open in editor

Bugfixes and improvements

New Contributors

Full Changelog: v1.25.2...v1.26.0

Contributors

eandre, boxofrad, and 2 other contributors
Assets 2
Loading

Build & Test Performance Improvements

16 Aug 09:34
@marcuskohlberg marcuskohlberg
v1.25.0
c329694
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
Build & Test Performance Improvements

We've just released Encore v1.25 which comes with several large build & test performance improvements!
As always, update with encore version update.

Improved CI Build & Test Speeds

Encore's CI system now uses a brand-new streaming cache system. Previously Encore tar and untar-ed the build & test cache, adding to the build time and leading to an unfortunate trade-off between cache hit rate and cache restore/save times.

With this release, Encore now uses a streaming cache that on-demand downloads and uploads individual cache entries. This entirely removes the cache restore/save steps, leading to a substantial speed-up. Additionally, the improved cache accuracy leads to more parts of the build being cached, further improving build times.

We've seen up to a 70% reduction in build & test times for many real-world applications, depending on the nature of the change.

Improved Local Development Performance

We've further optimized how Encore's code generation works, leading to improved build & test times, particularly when the changes are small (compared to the previous build). Depending on the change this new release should offer a 10% to 100% reduction in build times (yes, you heard that right!), and similar improvements to test execution speeds through improved test caching.

Additionally, we've further improved the Live Reload speed by improving the graceful shutdown process. More on that below.

Graceful Shutdown Improvements

Encore now implements a more optimized graceful shutdown process, reducing shutdown times when there are no outstanding requests being processed. Encore also provides the encore.dev/shutdown package that allows services to opt-in to more detailed information about the shutdown process, by implementing shutdown.Handler on a service struct.
The old signature (func (*Service) Shutdown(force context.Context)) is still supported for backward compatibility.

❤️ As always, we're excited to hear what you think!
Please share your feedback on Slack.

Assets 2
Loading
0 Join discussion