roast logo

Quick Start

Sign up and deploy

  1. Read the assumptions/requirements (SPA framework and pushstate URLs)
  2. Sign up (here on to create an account
  3. Install the Node.js client: npm install -g roast
  4. cd into your project directory
  5. Run roast deploy
  6. The CLI will first show an uploading state, then a prerendering state. (this should only take a few seconds)
  7. When done, the CLI will output the auto-generated URL
  8. You're done! Your app is now server side rendered and live across the CDN

Configure a custom domain (optional)

  1. After signing up and deploying your site
  2. sign in to, configure a custom domain
  3. Configure a www CNAME in your DNS provider for your
  4. Configure an A record and point it at:

AJAX (optional)

If you were previously hosting your single page app on the same server you were serving AJAX from, your AJAX probably "just worked", but moving your front-end to a static web host means your AJAX and front-end will be served from different domains. You have 2 options:

  1. add a _redirects file to your repository (read more)
  2. or configure CORS on your server