go read

a google reader clone built with go on app engine and angularjs

setting up a local dev environment

1. Install Python 2.7 and make sure it is in your PATH. (Google App Engine doesn't yet work with Python 3.)
2. Install Git and Mercurial and make sure git and hg are in your PATH.
3. Install the Go App Engine SDK.
4. 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.)
5. Further commands that use go, dev_appserver.py, and appcfg.py all live in the google_appengine directory from the SDK. Make sure it's in your PATH.
6. Download dependencies by running: go get -d github.com/mjibson/goread/goapp. This will download goread and all of its dependencies, and will stick them in your GOPATH.
7. cd $GOPATH/src/github.com/mjibson/goread.
8. git checkout master (bug in go get).
9. Copy app.sample.yaml to app.yaml.
10. In the goapp folder, copy settings.go.dist to settings.go.
11. From the goread directory, start the app with dev_appserver.py app.yaml. (On Windows, you may need to do this instead: python C:\go_appengine\dev_appserver.py app.yaml.)
12. View at localhost:8080, admin console at localhost:8000.

developer notes

1. Press alt+c to show the miniprofiler window.
2. Press c to clear all feeds and stories, remove all your subscriptions, and reset your unread date.

self host on production app engine servers

1. Set up a local dev environment as described above.
2. Create a new app engine application.
3. In app.yaml, change the first line to contain the name of the application you just created.
4. From the goread directory, deploy with appcfg.py update ..