Quick Start

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

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

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: 35.163.142.120

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