/create-torque-app

Quickly create a new torque app with the official template repository!

Primary LanguageGoMIT LicenseMIT

create-torque-app

create-torque-app is the official template repository for creating a new torque app. This project is designed as a starting point for building out web apps in Go using the torque framework.

Getting Started

Get started by clicking 'Use this template' above.

After you've created a new repository, clone it locally into your $GOPATH and run the one time setup script:

git clone <your-repo-url>
cd <your-repo-name>
./one_time_setup.sh

The one_time_setup.sh script does the following:

  • Changes necessary project files to match your new project name
  • Resolves go dependencies via go mod tidy
  • Install the build tool Taskfile via go install
  • Provides next steps for getting started
  • Deletes itself

The Stack

The create-torque-app template project is preconfigured with the following technologies:

  • torque - Webserver framework
  • htmx - Frontend framework
  • tmpl - Go html/template compiler and renderer
  • TailwindCSS - CSS framework

It also comes preconfigured with the following tooling:

  • Docker - Container runtime
  • eslint - JavaScript & HTML linter
  • prettier - JavaScript & HTML formatter
  • Taskfile - Task runner & mini build system

Project Structure

  • go.mod & go.sum - Golang module files for managing Go dependencies.
  • package.json & package-lock.json - Node module files for managing Node dependencies.

App directories

Directory Purpose
assets/
elements/
middleware/
model/
routes/
services/
styles/
templates/