README.app.md

AppPrototype

This is a Hanami 2 application.

Docker development

To bootstrap and setup the app and its assets server, just run:

script/setup docker

To start the app:

docker-compose up app

Local development

Requirements

The scripts below require Homebrew and asdf installed, and asdf added to your shell.

If you prefer different tools, remove Brewfile and .tool-versions, and adapt the script/ files (mentioned below) to use your preferred tools.

Local setup

After cloning, run:

./script/bootstrap

Running supporting services

To start the supporting services, run:

./script/support

These must be running before completing the following steps.

Setup

After the supporting services have started, run:

./script/setup

After pulling changes

After pulling changes from the remote, run:

./script/update

Running the app

To run the app:

./script/server

This launches the application processes using overmind, which places each into a tmux session. You can connect to a specific process to interact with it (which is useful when using an interactive debugger inside the web process):

overmind c web

⚠️ To detatch from the tmux session, use the ctrl+b,d shortcut.