Go vue Starter Kit for Heroku.

View online demo (API), Inspired by React firebase starter.

Tech Stack

• Vue CLI (★ 18k) for development and test infrastructure (see user guide)
• golang.org/x/oauth2 (★ 2k) for authentication configured with stateless JWT tokens for sessions
• graphql-go/graphql (★ 4.1k) for declarative data fetching and efficient client stage management
• PostgreSQL database pre-configured with a query builder and migrations using Sqlboiler (★ 1.7k) and Goose
• Heroku & Netlify for app architecture - Cloud SQL, CDN hosting (docs)

Also, you need to be familiar with HTML, CSS, JavaScript (ES2015) and Vue.

Prerequisites

• Go v1.11 or newer
• Node.js v8.11 or higher + Yarn v1.6 or higher   (HINT: On Mac install them via Brew)
• VS Code editor (preferred) + Project Snippets, EditorConfig, ESLint, Prettier, and Babel JavaScript plug-ins
• PostgreSQL v9.6 or newer, only if you're planning to use a local db for development

Getting Started

Just clone the repo, update environment variables in .env and/or .env.local file, and start hacking:

$ go get bitbucket.org/liamstask/goose/cmd/goose
$ go get -u -t github.com/volatiletech/sqlboiler
$ go get github.com/snapiz/go-vue-starter
$ cd ~/go/src/github.com/snapiz/go-vue-starter

# Setup
$ yarn install
$ yarn db:up

# Serve
$ yarn start

Then open http://localhost:9000/ to see your app.

How to Migrate Database Schema

$ yarn db:migration AddSomeColumns sql  # Create a new database migration file
$ yarn db:up                            # Migrate database to the latest version
$ yarn db:down                          # Rollback the latest migration
$ yarn db:models                        # Generate models from db

How to Test

$ yarn test:api                         # Run unit tests for server                          
$ yarn test:unit                        # Run unit tests.  
$ yarn test:e2e                         # Run end-to-end tests.

How to Deploy

1. Create a new heroku project and postgres database.
2. Configure heroku environement variables by running heroku config:set APP_ENV=production and for all variables in .env.
3. Configure Netlify netlify.toml with your own redirect domain or create web/public/_redirects.
4. Deploy your application by running yarn deploy.
5. Migrate your database schema if needed by running yarn heroku:db:up.

License

Copyright © 2019 snapiz. This source code is licensed under the MIT license found in the LICENSE file.