snowflake

Snowflake

Yet another Go application generator.

Features:

• Opinionated with the best practices.
• Simplicity with batteries.
• Idiomatic. Every Gopher loves that word.

Installation

go install github.com/gitkumi/snowflake@latest

Quick Start

Here is how to generate an application.

snowflake new acme -d postgres

Flags

• -d: Database type (sqlite3, postgres, or mysql)
• -t: App type (api or web)

Here is the full command with the default flags.

snowflake new acme -t api -d sqlite3 -o ./ --git=true --smtp=true --storage=true --auth=true

Note: Auth feature requires SMTP.

Stack

Snowflake is built with these packages. Make sure to check their documentation.

Dev

• air

Routing

• Gin

Database

• sqlc
• goose

Templating

• templ (only for "web" app type)

Commands

• make dev - Start the development environment with hot reload.
• make test - Run tests.
• make build - Build the project.
• make run - Run the build.
• make audit - Audit the project.
• make tidy - Tidy the modules and format the project.
• make db - Check database status.
• make db.up - Run database migration.
• make db.down - Roll back database migration by 1.
• make db.create - Create database.
• make db.destroy - Destroy database.
• make db.reset - Destroy and create database.
• make create <table_name> - Create an empty migration file.