a google reader clone built with go on appengine and angularjs.
setting up a local dev environment
- Install Python 2.7 and make sure it is in your
PATH
. (Google App Engine doesn't yet work with Python 3.)
- Install Git and Mercurial and make sure
git
and hg
are in your PATH
.
- Install the Go App Engine SDK.
- Set your
GOPATH
(to something like /home/user/mygo
), and make sure it's a directory that exists. (Note: set this on your machine's environment, not in the go.bat file.)
- Further commands use
goapp
which lives in the go_appengine
directory from the SDK. Make sure it's in your PATH
.
- Download dependencies by running:
goapp get -d github.com/mjibson/goread
. This will download goread and all of its dependencies, and will stick them in your GOPATH
.
-
cd $GOPATH/src/github.com/mjibson/goread
.
-
git checkout master
(bug in go get
).
- Copy
app.sample.yaml
to app.yaml
.
- In the
goread
directory, copy settings.go.dist
to settings.go
.
- From the
goread
directory, start the app with goapp serve
. (On Windows, you may need to do this instead: python C:\go_appengine\dev_appserver.py app.yaml
.)
- View at localhost:8080, admin console at localhost:8000.
developer notes
- Press
alt+c
to show the miniprofiler window.
- Press
c
to clear all feeds and stories, remove all your subscriptions, and reset your unread date.
self host on production app engine servers
- Set up a local dev environment as described above.
- Create a new app engine application.
- In
app.yaml
, change the first line to contain the name of the application you just created.
- From the
goread
directory, deploy with goapp deploy
from https://github.com/mjibson/goread, https://www.goread.io/