Skip to content

Latest commit

 

History

History
45 lines (35 loc) · 1.9 KB

README.md

File metadata and controls

45 lines (35 loc) · 1.9 KB

Telescope is an open-source, real-time social news site built with Meteor

Note: Telescope is beta software. Most of it should work but it's still a little unpolished and you'll probably find some bugs. Use at your own risk :)

Learn More

License

Features

  • Real-time (of course!)
  • Password-based and/or Twitter auth
  • Notifications
  • Mobile-ready & responsive
  • Invite-only access for reading and/or posting
  • Markdown support
  • Day by day view

Installation

  • Install Meteor
  • Install Meteorite
  • Download or clone Telescope into /some/path
  • cd /some/path
  • Run mrt

Hosting Telescope

I recommend using either Meteor's own free hosting service, or checking out Modulus.

First Run

  • Fill in your Twitter keys (by clicking on "Sign Up/Sign in" in your Telescope top bar)
  • The first user account created will automatically be made admin
  • Check out the settings page and fill out basic things like the site's name

Local Variables

Meteor uses local environment variables for a few things, such as configuring email. While some platforms (like Modulus) make it easy to configure them from their web dashboard, on a local dev environment the best way is to set up an alias for the mrt command. For example, to configure Meteor to use Mailgun for email, in your .bash_profile file just add: alias m='MAIL_URL=smtp://username:[email protected]:587/ mrt'

This can also be useful for starting Meteor on a specific port: alias m4='MAIL_URL=smtp://username:[email protected]:587/ mrt --port 4000'