Create a new production-ready project with backend (Golang), frontend (JavaScript, TypeScript)
and deploy automation (Ansible, Docker) by running one CLI command.
Focus on writing code and thinking of business-logic! The CLI will take care of the rest.
⚡️ Quick start
First of all, download and install Go. Version 1.11
or higher is required.
Next, download the latest version of the Create Go App CLI to your system:
go get github.com/create-go-app/cli
Installation is done by using the go build
command with $GOPATH/bin
:
go build -i -o $GOPATH/bin/cgapp github.com/create-go-app/cli
Let's create a new project via interactive console UI (or CUI for short) into current folder:
cgapp create
Okay, it works! Now, you can run this project on your local machine or deploy to a remote server. Project works in isolated Docker containers and automates via Ansible playbook:
cgapp deploy
That's all you need to start! 🎉
If you don't want to install Create Go App CLI to your system, you feel free to using our official Docker image and run CLI from isolated container:
docker run --rm -it -v ${PWD}:${PWD} -w ${PWD} koddr/cgapp:latest
With this Docker image, you do not have to worry about installing tools/CLI of frontend UI libraries/frameworks. Everything is already included: create-react-app
, preact-cli
, vue-cli
, ng-cli
and degit
(for Svelte and Sapper).
Available commands for official Docker image:
🔔 Please note: a
deploy
command is currently unavailable in this image.
A short video screencast to introduce main features of the Create Go App CLI.
🔗 https://youtu.be/5-DNZFU9TOQ
Unfortunately, we are unable to include all helpful documentation to the README
file. That's why, the best way to better explore all the features of the Create Go App CLI is to read the Official Documentation.
🔥 We've put together a subject index specifically for you, so you can find any answer you want in seconds!
CLI command for generate a default .cgapp.yml
config file in current folder:
cgapp init
📺 Preview: https://recordit.co/yvlnIu8Lyp
Generated config file
# Project config.
project:
# Backend for your project.
# (Required)
# String:
# - `net/http`
# - `fiber`
# - `echo`
# - `gin`
# User template: supported, set to URL (without protocol),
# like `github.com/user/template`
- backend: fiber
# Frontend for your project.
# (Optional, to skip set to `none`)
# String:
# - `react`
# - `react:<template>`
# - `preact`
# - `preact:<template>`
# - `vue`
# - `vue:<user/repo>` (for preset from GitHub)
# - `vue:<gitlab|bitbucket>:<user/repo>` (for presets from others)
# - `angular`
# - `svelte`
# - `sapper`
# - `sapper:<webpack>`
# User template: supported, set to URL (without protocol),
# like `github.com/user/template`
- frontend: svelte
# Web/Proxy server for your project.
# (Optional, to skip set to `none`)
# String: `nginx`
# User template: supported, set to URL (without protocol),
# like `github.com/user/template`
- webserver: nginx
# Automation config.
roles:
# Ansible roles for deploy your project.
# (Optional, to skip set to empty or comment)
# Objects list.
- deploy:
# Username of remote's server or local's user.
# (Required)
username: root
# If you need to deploy (or run) a project asking for a password
# for the user, set `become` to `true`. This is equivalent of
# `--ask-become-pass`, a standard Ansible argument
# to ask for a privilege escalation password.
# (Optional)
become: true
# Host name from your inventory file (usually, at /etc/ansible/hosts).
# (Required)
host: localhost
# Name of Docker network
# (Required)
network: cgapp_network
# Filename of Ansible playbook in the root of the Create Go App project.
# If you want to rename it, do it, but not to change destination of file!
# (Required)
playbook: deploy-playbook.yml
CLI command to create a new project with the selected configuration.
There's two ways to create a new project:
- With an interactive console UI (or CUI).
- From configuration file (by default, in
$PWD/.cgapp.yml
).
Run create
command without any arguments:
cgapp create
📺 Preview: https://recordit.co/LTxFQloedn
Run create
command with --use-config
(or -c
) argument:
cgapp create --use-config
CLI command for deploy Docker containers with your project to a remote server.
☝️ You should only run this command from the root folder of your project, which created with the
cgapp create
command! It's a necessary condition for everything to work perfectly.
There's, also, two ways to deploy your project:
- With an interactive console UI (or CUI).
- From configuration file (by default, in
$PWD/.cgapp.yml
).
Run deploy
command without any arguments:
cgapp deploy
📺 Preview: https://recordit.co/ewjG9dgMPX
Run deploy
command with --use-config
(or -c
) argument:
cgapp deploy --use-config
Backend:
-
net/http
— Backend template with Golang built-in net/http package. -
fiber
— Backend template with Fiber. -
echo
WIP — Backend template with Echo. -
gin
WIP — Backend template with Gin.
Frontend:
-
react
— React frontend app.react:<template>
— CRA generated template for React app.
-
preact
— Preact frontend app.preact:<template>
— Preact CLI generated template for Preact app.
-
vue
— Vue.js frontend app.vue:<user/repo>
— Preset for generating Vue.js app from GitHub.vue:<gitlab|bitbucket>:<user/repo>
— Preset for generating Vue.js app from GitLab/BitBucket/etc.
-
angular
— Angular frontend app. -
svelte
— Svelte frontend app. -
sapper
— Sapper frontend app for static websites.sapper:<webpack>
— Preset for generating Sapper with Webpack bundler.
☝️ Please note, that since version
v1.3.0
, frontend templates (in the classical sense) are not supported by the Create Go App CLI. Those templates, that we created (react-js
,react-ts
andpreact-js
), are still available, but only for use as user's custom templates.Now, the frontend part of your project will be generated using official CLI from the authors of each frontend UI library/framework (under the hood). So, you'll always get the latest version of
React
,Preact
,Vue.js
,Angular
,Svelte
orSapper
for your project from their authors!
Web/Proxy server:
When we started this project, we asked ourselves this question too and... came to the conclusion, that approximately 8 out of 10 routine operations at the start of a new project and/or the deployment of an existing one can be automated. And it would be better to have all the necessary functions inside one CLI. That's why we transferred all our experience to the Create Go App CLI, which we use ourselves!
So, yes, this CLI gives you the ability to prepare everything you need to start a new project (as create-react-app
for the React.js ecosystem does) and deploy an existing project to a remote server in configured and fully isolated Docker containers.
If you want to say thank you or/and support active development of Create Go App CLI
:
- Add a GitHub Star to the project.
- Twit about project on your Twitter.
- Write interesting articles about project on Dev.to, Medium or personal blog.
- Donate some money to the project's author via PayPal: @paypal.me/koddr.
Together, we can make this project better every day! 😘
Create Go App CLI
is free and open-source software licensed under the Apache 2.0 License. Official logo was created by Vic Shóstak and distributed under Creative Commons license (CC BY-SA 4.0 International).