Getting started - HTTP application

Yokai provides a ready to use HTTP application template to start your HTTP projects.

Overview

The HTTP application template provides:

• a ready to extend Yokai application, with the HTTP server module installed
• a ready to use dev environment, based on Air (for live reloading)
• a ready to use Dockerfile for production
• some examples of handler and test to get started

Layout

This template is following the recommended project layout:

• cmd/: entry points
• configs/: configuration files
• internal/:
  • handler/: HTTP handler and test examples
  • bootstrap.go: bootstrap
  • register.go: dependencies registration
  • router.go: routing registration

Makefile

This template provides a Makefile:

make up     # start the docker compose stack
make down   # stop the docker compose stack
make logs   # stream the docker compose stack logs
make fresh  # refresh the docker compose stack
make test   # run tests
make lint   # run linter

Installation

With GitHub

You can create your repository using the GitHub template.

It will automatically rename your project resources, this operation can take a few minutes.

Once ready, after cloning and going into your repository, simply run:

make fresh

With gonew

You can install gonew, and simply run:

gonew github.com/ankorstore/yokai-http-template github.com/foo/bar
cd bar
make fresh

Usage

Once ready, the application will be available on:

• http://localhost:8080 for the application HTTP server
• http://localhost:8081 for the application core dashboard

Going further

To go further, you can:

• check the HTTP server module documentation to learn more about its features
• follow the HTTP application tutorial to create, step by step, an HTTP application
• test the HTTP demo application to see all this in action