roast logo

Quick Start

Sign up and deploy

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

Configure Single-Page App (Optional)

Single-page app frameworks using pushstate URLs (Angular, React, Vue, etc.) need to return index.html instead of 404

  1. add a _redirects file (read more)
  2. Add this line: /* /index.html 200

Configure a custom domain (optional)

  1. After signing up and deploying your site
  2. sign in to, configure a custom domain in the dashboard (this step is often missed)
  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 (read more)
  2. or configure CORS on the server that's serving the AJAX requests