Skip to content

๐Ÿ”ฅ A next-generation CLI tool that makes it easy to create amazing web applications with Go on the backend, using htmx, hyperscript or Alpine.js, and the most popular CSS frameworks on the frontend.

License

Notifications You must be signed in to change notification settings

gowebly/gowebly

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

gowebly logo

The Gowebly CLI

A next-generation CLI tool to easily build amazing web applications with Go on the backend,
using htmx & hyperscript and the most popular CSS frameworks on the frontend.

English ยท ะ ัƒััะบะธะน ยท ็ฎ€ไฝ“ไธญๆ–‡ ยท Espaรฑol

Go version Go report
Code coverage License

โ†˜ย ย Share to your friends and familyย ย โ†™

Share on X Share on Telegram Share on WhatsApp Share on Reddit

โœจ Features

  • 100% free and open source under the Apache 2.0 license;
  • For any level of developer's knowledge and technical expertise;
  • Well-documented, with a lot of tips and assists from the authors;
  • Cross-platform and multi-architecture allows successful running on any GNU/Linux distros, Microsoft Windows (including WSL) and Apple macOS;
  • Smart CLI that does most of the routine setup and preparation for production;
  • Helps to get into the Go htmx hyperscript technology stack faster;
  • Supports the most popular Go web frameworks out of the box, such as Fiber, Gin, Echo, Chi and HttpRouter;
  • Supports the way web applications are developed using the Templ templating engine with hot-reloading;
  • The possibility of simply adding a ready-to-use and completely customized CSS framework to your project, such as Tailwind CSS, daisyUI, Flowbite, UnoCSS, Bulma and Bootstrap;
  • Ready to install as PWA (Progressive Web App) in your browser or mobile device;
  • Supports live-reloading mode for your CSS styles;
  • Has a library of user-friendly helpers for your Go code;
  • Documentation translated to multiple languages (ะ ัƒััะบะธะน, ็ฎ€ไฝ“ไธญๆ–‡, Espaรฑol);
  • Contains a comprehensive example of how to use it out of the box.

Tip

To give you a full understanding of the project, we have recorded a short ๐Ÿ“บ video and prepared an introduction ๐Ÿ“ article demonstrating the main features of the Gowebly CLI.

โšก๏ธ Quick start

First, download and install Go. Version 1.21 (or higher) is required.

Now, you can use the Gowebly CLI without installation. Just run it with go run to create a new project with a default configuration:

go run github.com/gowebly/gowebly@latest create

That's it! ๐Ÿ”ฅ A wonderful web application has been created in the current folder.

It will use the net/http package (as a Go backend) and the html/template package (as a template engine). The htmx and hyperscript libraries are already available in your HTML templates.

๐Ÿณ Docker-way to quick start

Feel free to using the Gowebly CLI from our official Docker image and run it in the isolated container:

docker run --rm -it -v ${PWD}:${PWD} -w ${PWD} gowebly/gowebly:latest create

Important

This Docker image works only on the GNU/Linux systems (amd64 or arm64, including WSL).

๐Ÿบ Homebrew-way to quick start

GNU/Linux and Apple macOS users available way to install Gowebly CLI via Homebrew.

Tap a new formula:

brew tap gowebly/tap

Install:

brew install gowebly/tap/gowebly

๐Ÿ“ฆ Other way to quick start

Download ready-made exe files for Windows, deb (for Debian, Ubuntu), rpm (for CentOS, Fedora), apk (for Alpine), or Arch Linux packages from the Releases page.

๐Ÿ“– Complete user guide

We always treasure your time and want you to start building really great web products on this awesome technology stack as soon as possible! Therefore, to get a complete guide to use and understand the basic principles of the Gowebly CLI, we have prepared a comprehensive explanation of the project in this ๐Ÿ“– Complete user guide.

gowebly docs banner

We have taken care to make it as comfortable as possible for you to learn this wonderful tool, so each CLI command has a sufficient textual description, as well as a visual diagram of how it works.

Important

Don't forget to switch the documentation to your language to make it even more comfortable to learn new knowledge! Supported languages: English, ะ ัƒััะบะธะน, ็ฎ€ไฝ“ไธญๆ–‡, Espaรฑol.

The learning path

It is highly recommended to start exploring with short introductory articles "What is Gowebly CLI?" and "How does it work?" to understand the basic principle and the main components built into the Gowebly CLI.

Next steps are:

  1. Install the CLI to your system
  2. Configure your project
  3. Start creating a new project
  4. Running your project locally
  5. Build your project for the production

Hope you find answers to all of your questions! ๐Ÿ˜‰

๐ŸŽฏ Motivation to create

Tell us, how often have you had to start a new project from scratch and had to make painful manual configurations? ๐Ÿค” Especially, when you are just getting acquainted with a new technology or stack, where everything is new to you.

For many developers, including us, this process is as tedious and even depressing as possible, and doesn't carry any useful workload. It is a very frustrating process that can push any developer away from technology a lot.

Why not just give all that awful manual work to machines? Let them do all the hard work for us, and we will just create awesome web products and not have to think about build and deploy.

That's why we created the Gowebly CLI and its helpers' library, which helps you start an amazing web applications in Go using htmx, hyperscript and popular CSS frameworks.

We are here to save you (and ourselves) from this routine pain! โœจ

Note

Earlier, I have already saved the world once, it was Create Go App (yep, that's my project too). The GitHub stars statistics of this project can't lie: more than 2.3k developers of any level and different countries start a new project through this CLI tool.

๐Ÿ† A win-win cooperation

If you liked the Gowebly CLI and found it useful for your tasks, please click a ๐Ÿ‘๏ธ Watch button to avoid missing notifications about new versions, and give it a ๐ŸŒŸ GitHub Star!

It really motivates us to make this product even better.

gowebly star and watch

And now, I invite you to participate in this project! Let's work together to create and popularize the most useful tool for developers on the web today.

Your PRs, issues & any words are welcome! Thank you ๐Ÿ˜˜

๐ŸŒŸ Stargazers

Stargazers over time

โš ๏ธ License

The Gowebly CLI is free and open-source software licensed under the Apache 2.0 License, created and supported by Vic Shรณstak with ๐Ÿฉต for people and robots. Official logo distributed under the Creative Commons License (CC BY-SA 4.0 International).