Simple start to a framework for Meteor (Mainly to stash hacks)
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Simple MVC for Meteor, it should help you build more advanced Meteor apps faster. Current version: 0.2.1

To use

To use this code copy the stellar directory into your meteor folder package folder.

You need to add in Stellar which isn't an official smart package yet You need to copy this project into the meteor packages for linux this should be: /usr/lib/meteor/packages/ for mac: /usr/local/meteor/packages/ In your projects folder you should be able to run:

git clone git://

In the app direcory now:

meteor add jquery
meteor add stellar

The jQuery dependency will be removed soon, but for now you will need to add it to your app


Code sample:

Posts = new Stellar.Collection('posts');

HomeController = new Stellar.Controller('home');
HomeController.index = function() {
  Stellar.render('hello', {greeting: 'Welcome home son'});

NewPageController = new Stellar.Controller('new_page');
NewPageController.index = function() {
  Stellar.render('hello', {greeting: 'Welcome home girl'});

This code above sets up seperate controllers home and new_page these also have an action. Clicking /new_page/ will show the new page controller. The Posts collection doesn't have any client side helpers so is secure straight away.

To use the functionality of above your template must look like:

  <title>App name</title>


<template name="hello">
  <div class="hello">
    <h1>Oh Stellar!</h1>
    <a href="/home/new_page/">New page</a>

For a working code version of this example visit: Interstellar

Session Usage

This is a little more complex and you need to be carefull to keep this secure. Because of Meteor not being able to directly set cookies on the client side this needs to be done in several stages.

There are 4 helper functions: Server side: Stellar.session.get(key) Stellar.session.set(data[, key]) Stellar.session.delete(key)

Client side: Stellar.session.getKey() Stellar.session.updateKey(key)

Get and set, do what you would expect and set and get the content of the session. These methods should be used in a login function like so:

  login: doLogin
function doLogin(username, password) {
  if(username && password == valid) { //psudocode
    key = Stellar.session.set(userObject);
    return {key: key}

The delete method should be called on the server side when the client wants to logout, if the user leaves the page they should at max have a valid session for 5 days. (More flexible options soon)

Then on the client side you then need to updateKey and getKey in a similar way. So all my methods needing a logged in user pass the key stored on the client side. For more about the design choices I wrote this session article.