bud

Bud

The Fullstack Go Framework for Prolific Web Developers.

Bud writes the boring code for you, helping you launch your website faster.

Installation

Run the following command in your terminal to install bud into your $PATH:

curl -sf curl https://raw.githubusercontent.com/livebud/bud/main/install.sh | sh

You can confirm the binary is working as expected with bud -h:

Usage:
  bud [flags] [command]

Flags:
  -C, --chdir  Change the working directory

Commands:
  build    build the production server
  create   create a new project
  run      run the development server
  tool     extra tools
  version  Show package versions

Create a new project

With bud installed, you can now scaffold a new project. Let's create a minimal hackernews clone:

$ bud create hackernews
$ cd hackernews

The create command will scaffold everything you need to get started with bud.

$ ls
go.mod  node_modules/  package-lock.json  package.json

... which is not very much by the way! Unlike most other fullstack frameworks, bud starts out very minimal. As you add dependencies, bud generates all the boring code to glue your app together. Let's see this in action.

Start the development server with bud run:

$ bud run
| Listening on http://0.0.0.0:3000

Click on the link to open the browser. You'll be greeted with bud's welcome page.

Congrats! You're running your first server with bud's help.

Hello World

The welcome page is cute, but it's time to make this web app our own.

Fire up your editor and create a controller/controller.go file. Inside this file, add the following code:

package controller

type Controller struct {
}

func (c *Controller) Index() string {
  return "hello world!"
}

Then if you glance back at your browser, you should see hello world. Now we're getting somewhere!