khodo

develop branch1 version
  • develop branchlatestJul 13, 2025

github.com/ntumbuka/khodo

A personal finance tracking tool

1 stars
0 dependents
License: MIT

Installation

# Add this to your shard.yml
dependencies:
  khodo:
    github: ntumbuka/khodo
    branch: develop

develop is a branch, not a release, so this tracks it rather than pinning a version.

Then run:

shards install

shard.yml

Crystal
>= 1.12.1
Target
  • khodo from src/khodo.cr

Dependencies

Runtime Dependencies

  • jwt~> 1.6.1github: crystal-community/jwt
  • avram~> 1.3.0github: luckyframework/avram
  • lucky~> 1.3.0github: luckyframework/lucky
  • carbon~> 0.6.0github: luckyframework/carbon
  • authentic>= 1.0.0, < 2.0.0github: luckyframework/authentic
  • lucky_env~> 0.2.0github: luckyframework/lucky_env
  • lucky_task~> 0.3.0github: luckyframework/lucky_task
  • carbon_sendgrid_adapter~> 0.6.0github: luckyframework/carbon_sendgrid_adapter

Development Dependencies

  • ameba*github: crystal-ameba/amebadev
  • lucky_flow~> 0.10.0github: luckyframework/lucky_flowdev

README

khodo

This is a project written using Lucky. Enjoy!

Quick setup

You can quickly get started with this app on Linux (Mac too possibly) if you have the following available:

  • Docker
  • Docker Compose
  • openssl (this is only needed to generate a random key - you can come up with your own)
  • curl or something like wget

Run the following instructions, once you have the above:

curl -L https://gitlab.com/ntumbuka/khodo/-/raw/develop/quick-setup.sh?ref_type=heads | sh -s

Setting up the project for development

  1. Install required dependencies
  2. Update database settings in config/database.cr
  3. Run script/setup
  4. Run lucky dev to start the app

Using Docker for development

  1. Install Docker
  2. Run docker compose up

The Docker container will boot all of the necessary components needed to run your Lucky application. To configure the container, update the docker-compose.yml file, and the docker/development.dockerfile file.

Learning Lucky

Lucky uses the Crystal programming language. You can learn about Lucky from the Lucky Guides.

Documentation

Read the API docs

Built from the current release. The first visit to a release nobody has asked for starts its build.

Links

This branch

Branch
develop
Seen
Jul 13, 2025
Crystal
>= 1.12.1
Indexed
yes

Dependents

No indexed shard depends on this one yet.

Repository

github.com/ntumbuka/khodo

Metadata

Created
Aug 12, 2026
Updated
Aug 15, 2026
Synced
Aug 15, 2026
Versions
1