node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



NPM version NPM downloads
Build Status
codecov donate


Server-side rendered Vue.js app should be made easy, since vue-router is well optimized for SSR, we built ream on the top of it to make you build universal Vue.js app fast with fewer trade-offs, the only requirement is to export router instance in your entry file, which means you have full control of vue-router as well!

How does this compare to Next.js/Nuxt.js?


Check out online docs or Try writing server-rendered Vue.js app online!


yarn add ream


You may use create-ream-app to kick start a new project, or add npm scripts manually:

  "scripts": {
    "build": "ream build",
    "start": "ream start",
    "dev": "ream dev"

Then populate an src/index.js in current working directory and it should export at least router instance:

import Vue from 'vue'
import Router from 'vue-router'
const createRouter = () => new Router({
  mode: 'history',
  routes: [/* ... */]
export default { createRouter }

Run npm run dev to start development server.

To run in production server, run npm run build && npm start

Dive into the documentation to get more.

Prior Art

ream wouldn't exist if it wasn't for excellent prior art, we're inspired by these projects:


  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D


ream © egoist, Released under the MIT License.
Authored and maintained by egoist with help from contributors (list). · GitHub @egoist · Twitter @rem_rin_rin