Go Angular Starter

Demo

Demo site available at: http://go-angular-starter.buz.co:3000/

Features

Go Angular Starter is a full stack opinionated template for advanced web applications. It includes:

Go HTTP Server with Go templates
Go REST API Server
Angular based Admin Panel single page app with Browserify, ES6 and SASS (using Gulp build tasks)
Authorisation (sign in, sign up, API key generation)
DB migrations with Goose
Yeoman generator for new entities

Quick Start

Install the project to your GOPATH:

go get github.com/cjdell/go_angular_starter

Install Go dependencies:

go get bitbucket.org/liamstask/goose/cmd/goose
go get github.com/jmoiron/sqlx
go get github.com/gorilla/rpc
go get github.com/gorilla/context
go get github.com/kylelemons/go-gypsy/yaml
go get github.com/kennygrant/sanitize

Set up the database. A Postgres SQL database is expected to exist called "go_angular_starter" on the localhost, accessible by the current user. You may need to change the configuration located at:

vim db/dbconf.yml

NOTE: You may wish to alter your pg_hba.conf to allow access via localhost without a password. This is assumed given the default dbconf.yml. Adding this line will allow access:

host    all   all   127.0.0.1/32    trust

Run the initial migration to create tables:

goose up  # Assuming $GOPATH/bin is in your PATH

Install NPM / Bower dependencies

sudo npm -g install gulp

cd $GOPATH/src/github.com/cjdell/go_angular_starter

npm install
bower install

Run the Gulp tasks (for Browserify / SASS compilation)

gulp  # Leave this running and open a new terminal

Run the HTTP server:

go run server.go

Database

To create a new migration, run:

goose create MIGRATION_NAME sql

i.e.

goose create NewTables sql

Then run:

goose up

To undo this migration:

goose down

Yeoman Generator

Quickly create entities using the Yeoman generator.

First do this once:

npm -g install yeoman
npm link generator

Then just type yo to run the generator.

Feedback

This is a project which I initially started as a exercise to see how one could build a full stack web framework in Go. I hope it is of use to people and I welcome feedback and pull requests. :-)