10 tips to get off the Meteor

A disclaimer before we get into this, in no way do I think the Meteor framework is bad. What I do know is our ambitions of where we want to take our platform are growing faster than the framework’s offering every release. So when it comes to the use case we had when we started this, it’s completely different.

When your company evaluates technology don’t make the same mistake we did. Lock in is real and NOT realizing the efficacy of your tool sooner will lead to more complications down the road. I could have written this blog post several times throughout the last 3 years, and now I’m noticing that my “tips” are increasing the more we lock ourselves further into the framework. The more time we develop, locking us in further, the more ideas you have to make later on to get out.

So the result, a campaign to free us from the lock in. Replace Meteor from the inside out slowly and get to a solution that provides us 100% control of our futures.

1. Replace Meteor Packages with NPM Modules

  • Any package that exists on NPM, switch to it.
  • Remove your Meteor packages in favor of NPM Modules
  • Refactor any of your organizations Meteor packages either into the imports directory or straight to an @org NPM Module.

2. Get off Iron Router



Here are a couple ideas for you:

  • Embrace another UI Library
  • Embrace a community route solution or the one that comes with the UI Library
  • Ensure you contribute, so in the case you get Iron Router’d you may be able to understand the inner working of both the project’s politics and code.

Getting off Iron Router can be done incrementally. Here’s our on-going plan:

  • Remove all Routing hooks and move them to the UI Layer
  • Remove all Subscriptions, and waitOns and move them to the UI Layer
  • Instrument a Routing interface between your application and a Routing Library
  • Replace Iron Router calls with this Routing Interface
  • Replace your UI Layouts that IronRouter made you have
  • Replace the library and update the interface for legacy code
  • Start writing new Routing code with interface or remove interface all together
  • Replace Iron Router Server side Routing with an Express Server. Explained below.

3. Remove Blaze ASAP

We adopted React.

Other options:

Angular 2, Angular 1, Vue, Preact, Ember

How we are moving off Blaze:

  • Start with child nodes of your UI Tree. Replace them into small Components and render them back into Blaze. If you’re using React you can use the React Template helper in Blaze
  • Once the child nodes are complete, get the parent node
  • Or you want to start from the top down, use this: https://github.com/gadicc/meteor-blaze-react-component to turn Blaze templates into React Components

4. Replace Minimongo/Tracker/ReactiveVar/Session

We use Redux to manage this client side state. Apollo Client does an amazing job of managing both UI State and the Domain State from your various microservices. Speaking of Microservices…

5. Microservice Feature Development

Think of any new feature as belonging to a new Microservice OR think of the improvement of an existing system in your stack as an opportunity to convert to a Microservice based architecture.

Once the Microservice is up, pipe the calls to it via your GraphQL Server.

6. Get on Apollo

How we are doing this:

  • Move everything that was an unnecessary reactive cost to Meteor Methods
  • Replace Meteor Methods with GraphQL queries and mutations.
  • Anything that was in a subscription that needed to be, like Users, keep in Meteor but plan for replacing with push based GraphQL Subscriptions.
  • Start incrementally adopting Apollo Client in your application. New features should be architected with Apollo and old features can be refactored during maintenance time or improvement times if you have the luxury.

7. Replace Kadira with another performance Monitoring Tool

Instrument New Relic

Instrument GraphQL

8. Mount an Express Server on your App

Here’s a really easy way to do this:

const express = require('express');
const compression = require('compression');
const bodyParser = require('body-parser');

const server = express();
// express middleware
server.use(bodyParser.json()); // application/json
server.use(bodyParser.urlencoded({extended: false})); // application/x-www-form-urlencoded
// install the express server within meteor webapp connect

Now you have an Express Server you can work with and slowly channel everything through.

9. Create a different Entry Point

I think the best way to replace your Meteor app from the inside out is to do the following:

  1. Make a .web or .client folder. This will make Meteor’s build tool unaware of this folder and will not build it in course of normal Meteor builds
  2. Install Webpack 2 and start scaffolding your new Single Page App
  3. If you need code from your main Meteor app that is not dependent on Meteor globals, you can import them just fine in the Webpack App
  4. For Legacy systems that still need DDP, use https://github.com/mondora/asteroid, if you want to share login state between this SPA and your main Meteor app (comment down below I can help you out). With Asteroid you can still hit your Meteor backend for legacy pub/sub and meteor methods. (But you should be using GraphQL right?)
  5. Once you have this new SPA you can build your Webpack bundle into your public directory and scaffold an index.html file using https://github.com/ampedandwired/html-webpack-plugin
  6. Once you have your JS Bundle, Vendor Bundle(if you need), and index.html in your public directory, make sure your app in production mode caches these in a CDN.
  7. For now, render your bundle on the client via an Express Server route. e.g. ‘/jobs’ if thats the starting point for this SPA
  8. Use the client side routing of the SPA to move throughout the app.
  9. While your App is running, load the meteor bundle in the background via an async script tag
  10. If you ever need an escape hatch back into Meteor, just route to that route directly outside of the pushState your SPA has.

If you have an app that loads 10mb, pretty much the whole world of your app on every route, you now can build mini single page apps that load in a matter of seconds.

Over time you can move your client into Webpack bundling and replace Meteor completely on the front end.

10. Peak your head in other communities





Software Engineer at Workpop, Inc.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store