Goyangi is a web foundation to help you getting started with a new web project based on Golang. It suits for you who want to develop SPA or mobile application. It also good example how to develop large web application that combined fancy golang packages. Goyangi means cat in Korean.
There are some good frameworks like a magic(Beego, Revel...). However these are too much.
Some of developers prefer to using micro frameworks and lightweight packages for flexibility and performance.
It's not easy to select and combine packages though.
So, Goyangi carefully chosen packages and combined.
Develop foundation codes that commonly used in web development.
Keep it simple and DRY.
Help creative lazybones.
Mercurial
Go
$ go get github.com/nitrous-io/goop
$ git clone dorajistyle/goyangi
$ cd goyangi
$ goop install
$ docker build -t "dorajistyle/goyangi" --no-cache .
update soon
You can find all configuration files in ./config
- api.go : API related configuration.
- authentication.go : Authentication related configuration.
- aws.go : If you want to use aws S3, you should setup configuration here.
- db.go : Be sure that you have a database for migration and run application.
- email.go : If you want to send an email to users, set your email information.
- environment.go : It has three type of environments. DEVELOPMENT | TEST | PRODUCTION
- frontend.go : Frontend related configuration.
- guid.go : Guid for build frontend. Use guid in the static url to ignore cache.
- image.go : Image related configuration.
- logger.go : Log related configuration.
- oauth.go : When you want to connect with oauth, set your oauth information.
- order.go : Ordering of models.
- pagination.go : Pagination of models.
- public.go : Public fields of user for privacy.
- uploader.go : Uploader related configuration.
$ gulp
It generates views.build.js from *.stache files. Also it generates css files and merges into application.css from *.scss file.
$ gulp watch
It watches *.stache files and *.scss files. When these files are modified, It generate views.build.js and application.css
$ node ./r.js -o build.js
It runs requirejs optimize and generate optimized files into ./frontend/canjs/static-build You can use this for production environment.
If you want to use share article to facebook, set your facebook app Id to exports.facebookAppId
If you want to use google map, set your key into googlemaps/params/key
- Restful support
- From Development to Deployment
- SPA ready
User is core of web application.
- User CRUD
- User Authentication
- Oauth
- User role for admin
- Permissions handling to access each API
- Email verification
- Password reset via email
- Following
- Activation
- MD5 for Gravatar
- Messaging
It's a foundation of basic board.
- Article CRUD
- Liking
- Comment
It's a foundation of basic location.
- Location CRUD
- Liking
- Comment
- Search on a google map
- Search on a other maps likes open street map.
It's a foundation of basic file upload.
- Upload files to local storage
- Upload files to amazon aws S3
- Upload files meta data to database
- Upload files to other cloud server
- Upload csv to database
Image handling included in uploads function.
- Resize (vips)
- Filtering (gift)
It's a foundation of statistics.
- ???
It's a foundation of Whatever you need
- You can add any foundation code that commonly used in web application.
- watcher for backend golang
goop exec watcher server
- wathcer for frontend
goop exec go run goyangi.go watcher
- BDD testing
goop exec go run goyangi.go test
- Generate API document
goop exec go run goyangi.go generateAPI
- Dockerfile You can find dockerfiles in ./dockerFiles
Goyangi separates server and frondend clearly. And default SPA frontend used canjs.
However developer can change the frontend easily. Just develop frontend and put it into 'frontend/'.
Goyangi uses great open source packages. You can check that which packages used in Goyangi web foundation.
- Add tons of BDD tests
- Improve documentation
- Automatically ignore private configuration when commit using git filter for contributors.
Just fork it, and enhance it.
When the Goyangi become more stable, developers become lazybones.
And then lazybones become creative.
Goyangi is under the MIT license