Skip to content

denisbakhtin/ginblog

Repository files navigation

GIN-powered blog boilerplate

This is a skeleton project that provides essentials most web blogs need - MVC pattern, user authorisation, orm, admin dashboard, javascript form validation, rss feeds, etc.

You can check out GinShop for a more modern e-shop bundle.

It consists of the following core components:

TODO (May be)

Screenshots

Home page

Blog post

Dashboard

Ckeditor 5 WYSIWYG editor

Custom 404, 405, 500 error pages

Usage

git clone https://github.com/denisbakhtin/ginblog.git
cd ginblog
go get .

Copy sample config cp config/config.json.example config/config.json, create postgresql database, modify config/config.json accordingly. Install npm, webpack, run npm install in the project directory.

Type go run main.go to launch web server, npm run build to rebuild assets.

Deployment

npm run build
make build

Upload ginblog binary config, views and public directory to your server.

Project structure

/config

Contains application configuration file & go wrapper.

/controllers

MVC controllers

/models

Database models.

/public

All web-site static files

/views

Web-site views.

main.go

Main file that starts the application, initializes subsystems and web routes

Make it your own

I assume you have followed installation instructions and you have ginblog installed in your GOPATH location.

Let's say you want to create Amazing Website. Add a new GitHub repository https://github.com/denisbakhtin/amazingblog (of course replace that with your own repo).

Prepare ginblog: delete its .git directory.

Issue:

rm -rf src/github.com/denisbakhtin/ginblog/.git

Replace all references of github.com/denisbakhtin/ginblog with github.com/denisbakhtin/amazingblog:

grep -rl 'github.com/denisbakhtin/ginblog' ./ | xargs sed -i 's/github.com\/denisbakhtin\/ginblog/github.com\/denisbakhtin\/amazingblog/g'

Move all files to the new location:

mv src/github.com/denisbakhtin/ginblog/ src/github.com/denisbakhtin/amazingblog

And push it to the corresponding repo:

cd src/github.com/denisbakhtin/amazingblog
git init
git add --all .
git commit -m "Amazing Blog First Commit"
git remote add origin https://github.com/denisbakhtin/amazingblog.git
git push -u origin master

You can now go back to your GOPATH and check if everything is ok:

go install github.com/denisbakhtin/amazingblog

And that's it.

Continuous Development

For Continuous Development a good option is to install fresh - https://github.com/pilu/fresh Then simply run fresh in the project directory.

To rebuild assets on change install run npm run watch.