Quick Start

Sign up and deploy

  1. Sign up (here on roast.io) 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 roast.io 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 roast.io, configure a custom domain in the roast.io dashboard (this step is often missed)
  3. Configure a www CNAME in your DNS provider for your your-sites-auto-generated-name.roast.io
  4. Configure an A record and point it at: or or both

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) to proxy (200 rewrite) XHR requests from a local path, say, /api/v1 to your origin server on a different host
  2. or configure CORS on the server that's serving the AJAX requests



Modern Web Hosting