cli

README

Create Go App CLI

Set up a new Go (Golang) full stack app by running one CLI command!

    

⚡️ Quick start

Let's create a new app into ./app folder with Fiber as backend and Preact as frontend:

cgapp create -p ./app -b fiber -f preact

That's all you need to start! 😉

⚙️ Installation

First of all, download and install Go. Version 1.11 or higher is required.

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

Check, that the CLI is installed correctly by the --version (or -v) command:

cgapp --version

# cgapp version X.X.X

~ Alternative installations

We're using a GoReleaser project for shipping standalone Create Go App CLI version to all major desktop platforms: Apple macOS, GNU/Linux, MS Windows. By default, for amd64 (x86_64) architecture.

If you need this version, please go to the repository release page and download zipped archive.

📚 Commands & Options

cgapp [command] [command options] [arguments...]

☝️ Tip you can see all available commands by running command with --help (or -h) option.

create

Creates a new Go app.

cgapp create --help

NAME:
   cgapp create - create a new Go app

USAGE:
   cgapp create [command options] [arguments...]

OPTIONS:
   --path value, -p value       path to create app, ex. ~/projects/my-app (default: ".")
   --backend value, -b value    backend for your app, ex. Fiber, Echo (default: "net/http")
   --frontend value, -f value   frontend for your app, ex. Preact, React.js, React.ts (default: "none")
   --webserver value, -w value  web/proxy server for your app, ex. Nginx (default: "none")
   --database value, -d value   database for your app, ex. Postgres (default: "none")
   --help, -h                   show help

🔔 Please note: by default, cgapp create command without any options will create into current folder default backend (net/http) without frontend or configured Docker containers!

📝 Available production-ready app templates

Golang:

• net/http create-go-app/net_http-go-template — Backend template with built-in net/http (pkg/net/http).
• fiber create-go-app/fiber-go-template — Backend template with Fiber (gofiber/fiber).
• echo WIP create-go-app/echo-go-template — Backend template with Echo (labstack/echo).

JavaScript:

• react-js create-go-app/react-js-template — Frontend template with React.js (facebook/react).
• react-ts create-go-app/react-ts-template — Frontend template with React.js TypeScript (facebook/react).
• preact create-go-app/preact-js-template — Frontend template with Preact (preactjs/preact).

🐳 Available production-ready Docker containers

Web/Proxy server:

• nginx create-go-app/nginx-docker — Docker container with Nginx.

Database:

• postgres WIP create-go-app/postgres-docker — Docker container with PostgreSQL.

👤 User templates & containers

Create Go App CLI provide creation your own template, instead of those prepared by authors. It's easy! 😉

Just specify backend (-b), frontend (-f), webserver (-w) and database (-d) with addresses to your repositories and run:

cgapp create \
             -b github.com/user/my-back-template \
             -f gitlab.com/user/my-front-template \
             -w github.com/user/my-webserver-container-template \
             -d bitbucket.org/user/my-database-container-template

🔔 Please note: the https:// protocol will add automatically!

🤔 FAQ

How to update CLI to latest version?

You can just re-build the CLI. The latest version will be downloaded and installed automatically:

go build -i -o $GOPATH/bin/cgapp github.com/create-go-app/cli

If you're using standalone version, please go to the release page and download archive with a new version.

⭐️ Project assistance

If you want to say thank you or/and support active development create-go-app/cli:

1. Add a :octocat: GitHub Star to the project.
2. Twit about project on your Twitter.
3. Donate some money to project author via PayPal: @paypal.me/koddr.
4. Join DigitalOcean at our referral link (your profit is $100 and we get $25).
5. Buy awesome domain name with 5% discount at REG.COM.

Thanks for your support! 😘 Together, we make this project better every day.

~ Sponsors

Logo	Description	URL
	True web artisans — Team who making UX efficiency review, friendly UI design, smart backend microservices, high-quality web apps and many more.	https://1wa.co
	💡 Want to become a sponsor too?

⚠️ License

MIT © Vic Shóstak & True web artisans.