getting-started.md

Title: Getting started with aah framework Desc: It is very easy to start and work with aah framework. Keywords: getting started, aah, aah Go web framework

Getting started with aah

It is very easy to start and work with aah. Let's make sure you have Go environment ready.

Note: Since v0.12.0 aah requires >= go1.11.

Table of Contents

• Installing aah CLI
• Verifying aah CLI
• Creating first aah application
• Running aah application

Installing aah CLI

aah user have multiple ways to install CLI into their system.

Note: Everytime you update Go, you must reinstall aah CLI, using one of the methods below.

Via Installer

macOS, Linux, BSD systems and Windows with Cygwin.

# Installs latest version of aah CLI
$ curl -s https://aahframework.org/install-cli | bash
# OR
$ wget -qO- https://aahframework.org/install-cli | bash

Install from Source for all platforms

$ git clone -b 'version-number' --single-branch --depth 1 https://github.com/go-aah/tools.git aah-cli

# on *nix systems
$ cd aah-cli/aah && env GO111MODULE=on go install

# on Windows
$ set GO111MODULE=on 
$ cd aah-cli/aah
$ go install

Verify aah CLI

Checking aah CLI version. Learn more about aah CLI.

aah --version

Congratulations, you have successfully installed aah CLI and it's ready to use :).

Creating first aah application

It is very easy to use aah CLI tool. Learn more about aah CLI using aah help.

<script src="https://asciinema.org/a/hz07lUuceCmDxdfMfjrv7nJhr.js" id="asciicast-hz07lUuceCmDxdfMfjrv7nJhr" data-speed="2" data-theme="monokai" data-rows="22" async></script>

Running aah application

# Go to application base directory
aah run

<script src="https://asciinema.org/a/pBDbLienJ9FzgFFoXKMDKT5Jn.js" id="asciicast-pBDbLienJ9FzgFFoXKMDKT5Jn" data-speed="2" data-theme="monokai" data-rows="30" async></script>

Open up the browser then navigate to address http://localhost:8080 to see aah application in action.

You will see a page like: