bkuhlmann / hemo

A Hanami demo application.

Hemo

Hemo is a portmanteau (i.e. [H]anami + D[emo] = Hemo) which is designed to provide a fully working demo Hanami application as built by the Hanamismith gem.

⚠️ This application is meant for demonstration purposes only which means all commits are heavily rebased as new functionality is implemented. You can definitely clone this project — and is encouraged — but I wouldn’t recommend forking this project because the SHAs will be constantly changing since each commit is meant to tell a story so people can learn how this application was architected. If you do clone (or download) a copy of this application, please note you’ll have to re-clone/download with any new changes pushed to this repository.

Table of Contents

• Features
• Screencasts
• Requirements
• Setup
• Usage
• Tests
• License
• Security
• Code of Conduct
• Contributions
• Community
• Credits

Features

• Uses Hanamismith for building the initial project skeleton and application architecture.

• Uses modern Hanami (backend) and htmx (frontend) technology to rapidly develop full featured web applications.

• Uses modern CSS for stylesheets.

• Provides a simple task management system for demonstration purposes where you can view, create, edit, update, and destroy tasks.

Screencasts

See Hanamismith for details.

Requirements

1. Ruby.

2. PostgreSQL.

3. Overmind (optional but recommended).

Setup

To set up the project, run:

git clone https://github.com/bkuhlmann/hemo
cd hemo
bin/setup

Usage

For access to the console, run:

bin/console

To view all Rake tasks, run:

rake -T

To view all Hanami CLI or CLI subcommand options, run:

bin/hanami -h
bin/hanami db -h

To develop — red, green, refactor — with Guard, run:

bin/guard

To launch the server, use any of the following:

# With Overmind (recommended)
overmind start --procfile Procfile.dev

# Without Overmind
bin/hanami server

Once the server is running, you can view the app via the following URLs:

• https://localhost:2443 (secure)

• http://localhost:2300 (insecure)

You can also check the status (health) of the app by hitting the /up endpoint.

Tests

To test, run:

bin/rake

License

Security

Code of Conduct

Contributions

Community

Credits

• Built with Hanamismith.

• Engineered by Brooke Kuhlmann.