[go: up one dir, main page]

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

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

gowebly logo

The Gowebly CLI

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.

Go version Go report License

โ†˜ย ย The official Gowebly CLI documentationย ย โ†™

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

โ†˜ย ย Share the project's link to your friendsย ย โ†™

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

gowebly create command

โœจ Features

  • 100% free and open source under the Apache 2.0 license.
  • For any developer's level of knowledge and technical expertise, as the intelligent CLI does most of the routine project setup for you, creates an understandable structure, and prepares code for use and deployment in production.
  • Cross-platform and multi-architecture allows successful running on any GNU/Linux distros, Microsoft Windows (including WSL) and Apple macOS.
  • Well-documented, includes translations in many other languages (ะ ัƒััะบะธะน, ็ฎ€ไฝ“ไธญๆ–‡, Espaรฑol).
  • Enables you to start a new project faster with Go, htmx, hyperscript or Alpine.js libraries.
  • Supports the built-in net/http package and the most popular Go web frameworks and routers out of the box, such as Fiber, Gin, Echo, Chi, HttpRouter, Gorilla/Mux and PocketBase.
  • Supports the most popular CSS frameworks out of the box, such as Tailwind CSS, daisyUI, Flowbite, Preline UI, UnoCSS, Bootstrap and Bulma.
  • Supports a new JavaScript runtime environment called Bun for the frontend.
  • Supports a way to build HTML with Go using the Templ package.
  • Supports a live-reload mode for your Go code and frontend files using Air tool.
  • Includes a basic config for golangci-lint for quick setup.
  • Ready-to-use Dockerfile and Docker Compose files to deploy your application in any environment.
  • Ready-to-install as PWA (Progressive Web App) in your browser or mobile device.
  • Has a library of user-friendly helpers for your Go code.

โšก๏ธ Quick start

Note

Looking for the Gowebly CLI v1? It's located in this branch.

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

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

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

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

๐Ÿบ 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

I 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

I 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's highly recommended to start exploring with short 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. Start creating a new project
  3. Running your project locally

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

๐ŸŽฏ Motivation to create

Tell me, 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 me, 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 the Gowebly CLI was born. It allows you to start a new project faster with Go, htmx, hyperscript or Alpine.js, Templ and the most popular CSS frameworks.

I am here to save you from this routine pain! โœจ

๐Ÿ† 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 me 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 ๐Ÿ˜˜

โค๏ธ Support the author

You can support the author of the Gowebly project on the Boosty platform.

Each of your donation will be aimed at supporting servers with official documentation, improving the quality of the CLI and implementing new features.

support the author on Boosty

๐Ÿ‘ฉโ€๐Ÿ’ป๐Ÿ‘จโ€๐Ÿ’ป Contribute to the project

If you want to contribute to the project, please read the contributing guide first.

๐ŸŒŸ Stargazers

The Gowebly CLI star history chart

โš ๏ธ 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).