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: 13.248.150.194 or 76.223.25.187 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

roast.io

logo

Modern Web Hosting

Contact


support@roast.io


@roast_io