wangjing031879 / ion

❍ — an experimental new engine for SST

❍

• 10x faster deploys
• Native multi-region support
• No more cyclical dependencies
• No stacks or stack resource limits
• No CDK or npm package conflicts
• Native support for non-AWS providers

Read the full announcement here.

Note: Ion is currently in alpha and only supports deploying Next.js sites and L1 AWS resources. We'll be sharing docs and technical details soon.

Installation

macOS

sst is available via a Homebrew Tap, and as downloadable binary from the releases page:

brew install sst/tap/sst

To upgrade to the latest version:

brew upgrade sst

You might have to run brew update before upgrading.

Linux

sst is available as downloadable binaries from the releases page. Download the .deb or .rpm from the releases page and install with sudo dpkg -i and sudo rpm -i respectively.

For arch linux it's available in the aur

Windows

sst is available via scoop, and as a downloadable binary from the releases page:

scoop bucket add sst https://github.com/sst/scoop-bucket.git
scoop install sst

To upgrade to the latest version:

scoop update sst

Manually

Download the pre-compiled binaries from the releases page and copy to the desired location.

Quick start

1. Create a new Next.js app.

   npx create-next-app@latest

2. Initialize SST in the root of your Next.js app.

   cd my-app
   sst create

   • This creates an sst.config.ts in your project root.
   • sst.config.ts is automatically added to the the exclude array in tsconfig.json to prevent TypeScript from trying to type-check it when building your app
   • You should also add /.sst and /.open-next to your .gitignore file.

3. Deploy! Ensure you have AWS credentials setup and run:

   sst deploy

Custom domains

You can configure the app with a custom domain hosted on Route 53.

new Nextjs("Web", {
  domain: "my-app.com",
});

You can setup www.my-app.com redirect to my-app.com.

new Nextjs("Web", {
  domain: {
    domainName: "my-app.com",
    redirects: ["www.my-app.com"],
  },
});

Or you can have www.my-app.com serve out the same site without redirecting.

new Nextjs("Web", {
  domain: {
    domainName: "my-app.com",
    aliases: ["www.my-app.com"],
  },
});

---

Join the #ion channel in our Discord to learn more and contribute.