/gowebly

🔥 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.

Primary LanguageGoApache License 2.0Apache-2.0

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, 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.

↖ Back to top

🐳 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).

↖ Back to top

🍺 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

↖ Back to top

📦 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.

↖ Back to top

📖 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.

↖ Back to top

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! 😉

↖ Back to top

🎯 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.

↖ Back to top

🏆 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 😘

↖ Back to top

🌟 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).