Skip to content

Instantly share code, notes, and snippets.

@mbleigh
Last active November 2, 2016 08:52
Show Gist options
  • Star 1 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save mbleigh/c34620557a414ca2f04a to your computer and use it in GitHub Desktop.
Save mbleigh/c34620557a414ca2f04a to your computer and use it in GitHub Desktop.
Divshot to Firebase Hosting migration guide

Firebase Migration Guide

Divshot has joined Google's Firebase! You can read more about the announcement on the Firebase blog. This guide is here to help you migrate and export your existing Divshot apps to Firebase Hosting.

If you don't already have a Firebase account, you'll need to create one. To do so, just visit firebase.com and sign up with your Google account.

Migrating Your Divshot Apps

Firebase Hosting is a full-featured static web hosting solution that is closely compatible with Divshot. In just a few minutes, you'll be able to get your existing Divshot apps up and running on Firebase.

Creating Firebase Projects

The fastest way to get started is to create a Firebase project for each of the Divshot apps you want to migrate. The Firebase Account Dashboard makes it easy to create new applications. Remember that your application name will also be your subdomain URL on firebaseapp.com.

Getting Ready to Migrate

The Divshot CLI has been updated with a migration assistant to make the process as easy as possible. You'll also want to get the latest version of the Firebase CLI. You can update and install both with the following command:

npm install -g divshot-cli firebase-tools

You'll also want to make sure that you're logged in to both Divshot and Firebase from the command-line by running these commands:

divshot login
firebase login

Migrating Apps

To migrate an individual app, you should perform the following steps:

  1. Open a command-line prompt in your app's directory (the one with divshot.json).
  2. Run divshot migrate and follow the on-screen prompts. This command will help you transform your divshot.json into a firebase.json.
  3. Once your firebase.json is ready, test it out locally by running firebase serve. This will start up a web server on localhost that works with your project's configuration. It's also powered by Superstatic, the same static web server used by Divshot!
  4. Now it's time to deploy. Simply run firebase deploy to deploy your site to Firebase Hosting. Once deployed, it will be available at your-project.firebaseapp.com.

That's all there is to it! Just repeat the process for each Divshot app you want to migrate and you'll be good to go in no time.

The divshot migrate command may advise you about some differences between Divshot and Firebase Hosting. If you have any questions, feel free to email support@firebase.com.

Adding a Custom Domain

Once you've gotten your site up and running, you'll likely want to add a custom domain. There are some notable differences between Firebase Hosting and Divshot in this area:

  1. Firebase Hosting manages SSL for you! When adding a custom domain, you'll be asked to add some TXT records to verify ownership. Once you've done that, we'll provision an SSL certificate on your behalf. No more having to buy and manually install certs.
  2. Firebase Hosting is HTTPS-only! More and more of the web is moving to HTTPS-only and Firebase has been ahead of the curve. All Firebase Hosting sites are served exclusively over HTTPS and HTTP traffic is redirected to HTTPS automatically.
  3. Firebase Hosting supports apex domains! With Firebase Hosting, you can use an apex domain (e.g. mydomain.com instead of www.mydomain.com) for your site without having to use a DNS provider that explicitly supports it.
  4. Domain Redirects are Automatic. Firebase Hosting allows you to assign a single canonical domain or subdomain for your app. All other subdomains will be automatically redirected to the canonical one, so it's super-easy to set up an apex domain and www for the same site.
  5. Firebase subscriptions are per-project. You will need to sign up for a subscription for the Firebase project before you can add a custom domain. For Divshot users we recommend the $5 "Spark" plan.

To actually add a custom domain to your newly migrated Divshot apps, we recommend you simply read and follow the Adding a Custom Domain guide in the Firebase docs.

Exporting Divshot Architect Projects

Divshot Architect will be shutting down permanently on December 22, 2015. If you have any active projects, you will need to export them before that date.

All Divshot Architect projects can be exported as a .zip file containing all of the project files. To do so, just open up architect.divshot.com, open up the project of your choice, and click the Export Project button in the upper left-hand corner.

In a few moments, your browser should begin downloading a zip file with your project's contents. You do not need to delete your Architect projects; they will automatically be deleted on December 14.

Frequently Asked Questions

What's happening to Divshot Hosting?

Divshot Hosting will wind down operation on December 14, 2015. The good news is Firebase Hosting is closely compatible with Divshot hosting and we've made it easy to transition your Divshot apps!

Firebase Hosting doesn't support Feature X, what do I do?

If Firebase Hosting doesn't yet support a critical Divshot feature you need, we encourage you to email support@firebase.com -- we may be able to help you find an alternative way to do what you want, or the feature may be in the near-term future for Firebase Hosting!

What's happening to Divshot Architect?

Unfortunately Architect is being retired as a product on December 14, 2015. If you have data you'd like to keep, you should export your projects to .zip as described above by December 13.

Are you sharing my customer data with Google?

No. While we'd love for you to migrate all of your existing applications to Firebase Hosting, none of your data has been or will be automatically shared with Google or Firebase.

I'm a paying customer. What will happen to my subscription?

Divshot will stop charging recurring monthly charges on November 13, 2015, 30 days before the Divshot products stop operation. Any active subscriptions at that time will be kept active until shutdown.

Does Firebase Hosting have a free plan?

Yes! Firebase Hosting has a free plan for a firebaseapp.com subdomain and 10GB of monthly bandwidth. Custom domains are not available at this time on the free plan for Firebase Hosting. You can add a custom domain to your Firebase Hosting application by upgrading to the Spark plan at $5 per month.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment