Enable CORS on your serverless application with a single boolean

Brian Leroux’s avatar

by Brian Leroux

Mountains photo by Rye Jessen

Previous versions of this post referred to using CORS in a now out of date version of Architect; however, we have preserved forwards compatibility in our runtime helper library @architect/functions, and updated this post.

CORS is often painful to implement. But with Architect we’ve made it significantly nicer to work with. Now you can build an API and retrieve your data from any static website.

Let’s give it a whirl.

First, create a simple project on GitHub with a single index.html file:

<b>hi from github pages!</b>

Click on Settings → GitHub Pages and set the source to the master branch you just pushed. That’ll take a second to build, so let’s set up the API!

We’ll build an Architect project in the same repo (why not):

touch .arc
npm init --yes
npm i @architect/architect

Edit the .arc manifest:

And now run npx create to generate an API endpoint, and edit the function handler in src/http/get-index like so:

let arc = require('@architect/functions')
async function http(req) {
  return {
    cors: true,
    body: JSON.stringify({ hello: 'world' })
exports.handler = arc.http.async(http)

That’s it. CORS has been reduced to a boolean! Deploy your Lambda with npx deploy (and note the deployment URL).

We’ll now return to our GitHub Pages code in index.html and add a little bit of client-side JS goodness:

<b>hi from github pages!</b>
<script type=module>

async function main() {
  let url = `${your deployment URL here}`
  let req = await fetch(url)
  let json = await req.json()

Deploy the frontend by checking in the code and hop on over to your GitHub Pages URL to preview your handy work. Cross-Origin Resource Sharing! Neat.

This means we can build our frontend application using the modern frontend development tools you’re accustomed to, while leveraging all of the serverless AWS power from a completely separate domain. All without having to resort to setting up DNS. JAMstack devs rejoice! 🚀