Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/olebedev/go-starter-kit
[abandoned] Golang isomorphic react/hot reloadable/redux/css-modules/SSR starter kit
https://github.com/olebedev/go-starter-kit
browser components golang isomorphic react redux server-side-rendering universal
Last synced: 21 days ago
JSON representation
[abandoned] Golang isomorphic react/hot reloadable/redux/css-modules/SSR starter kit
- Host: GitHub
- URL: https://github.com/olebedev/go-starter-kit
- Owner: olebedev
- License: other
- Archived: true
- Created: 2015-06-13T14:43:53.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-03-05T19:51:28.000Z (over 6 years ago)
- Last Synced: 2024-04-24T15:22:06.774Z (about 2 months ago)
- Topics: browser, components, golang, isomorphic, react, redux, server-side-rendering, universal
- Language: Go
- Homepage:
- Size: 10.6 MB
- Stars: 2,821
- Watchers: 97
- Forks: 360
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Lists
- awesome-stars - go-starter-kit - Golang isomorphic react/hot reloadable/redux/css-modules starter kit (Go)
- awesome-stars - go-starter-kit - modules/SSR starter kit | olebedev | 2818 | (Go)
- my-awesome-stars - olebedev/go-starter-kit - [abandoned] Golang isomorphic react/hot reloadable/redux/css-modules/SSR starter kit (Go)
- awesome - olebedev/go-starter-kit - [abandoned] Golang isomorphic react/hot reloadable/redux/css-modules/SSR starter kit (Go)
- awesome-stars - go-starter-kit - Golang isomorphic react/hot reloadable/redux/css-modules starter kit (Go)
- awesome - go-starter-kit - Golang isomorphic react/hot reloadable/redux/css-modules/SSR starter kit (Go)
README
# go-starter-kit [](https://app.wercker.com/project/bykey/cd5a782c425b1feb06844dcc701e528c) [](https://gitter.im/olebedev/go-starter-kit?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
> This project contains a quick starter kit for **Facebook React** Single Page Apps with **Golang** server side render via goja javascript engine, implemented in pure Golang and also with a set of useful features for rapid development of efficient applications.
## What it contains?
* server side render via [goja](https://github.com/dop251/goja)
* api requests between your react application and server side application directly via [fetch polyfill](https://github.com/olebedev/gojax/tree/master/fetch)
* title, Open Graph and other domain-specific meta tags render for each page at the server and at the client
* server side redirect
* embedding static files into artefact via bindata
* high performance [echo](https://github.com/labstack/echo) framework
* advanced cli via [cli](https://github.com/codegangsta/cli)
* Makefile based project
* one(!) terminal window process for development
* routing via [react-router](https://github.com/reactjs/react-router)
* ES6 & JSX via [babel-loader](https://github.com/babel/babel-loader) with minimal runtime dependency footprint
* [redux](https://rackt.org/redux/) as state container
* [redux-devtools](https://github.com/gaearon/redux-devtools)
* css styles without global namespace via PostCSS, [css-loader](https://github.com/webpack/css-loader) & css-modules
* separate css file to avoid FOUC
* hot reloading via [react-transform](https://github.com/gaearon/babel-plugin-react-transform) & [HMR](http://webpack.github.io/docs/hot-module-replacement.html)
* webpack bundle builder
* eslint and golint rules for Makefile
## Workflow dependencies
* [golang](https://golang.org/)
* [node.js](https://nodejs.org/) with [yarn](https://yarnpkg.com)
* [GNU make](https://www.gnu.org/software/make/)
Note that probably not works at windows.
## Project structure
##### The server's entry point
```
$ tree server
server
├── api.go
├── app.go
├── bindata.go <-- this file is gitignored, it will appear at compile time
├── conf.go
├── data
│ └── templates
│ └── react.html
├── main.go <-- main function declared here
├── react.go
└── utils.go
```
The `./server/` is flat golang package.
##### The client's entry point
It's simple React application
```
$ tree client
client
├── actions.js
├── components
│ ├── app
│ │ ├── favicon.ico
│ │ ├── index.js
│ │ └── styles.css
│ ├── homepage
│ │ ├── index.js
│ │ └── styles.css
│ ├── not-found
│ │ ├── index.js
│ │ └── styles.css
│ └── usage
│ ├── index.js
│ └── styles.css
├── css
│ ├── funcs.js
│ ├── global.css
│ ├── index.js
│ └── vars.js
├── index.js <-- main function declared here
├── reducers.js
├── router
│ ├── index.js
│ ├── routes.js
│ └── toString.js
└── store.js
```
The client app will be compiled into `server/data/static/build/`. Then it will be embedded into go package via _go-bindata_. After that the package will be compiled into binary.
**Convention**: javascript app should declare [_main_](https://github.com/olebedev/go-starter-kit/blob/master/client/index.js#L4) function right in the global namespace. It will used to render the app at the server side.
## Install
Clone the repo:
```
$ git clone [email protected]:olebedev/go-starter-kit.git $GOPATH/src/github.com//
$ cd $GOPATH/src/github.com//
```
Install dependencies:
```
$ make install
```
## Run development
Start dev server:
```
$ make serve
```
that's it. Open [http://localhost:5001/](http://localhost:5001/)(if you use default port) at your browser. Now you ready to start coding your awesome project.
## Build
Install dependencies and type `NODE_ENV=production make build`. This rule is producing webpack build and regular golang build after that. Result you can find at `$GOPATH/bin`. Note that the binary will be named **as the current project directory**.
## License
MIT