Kind metrics analytics for your website analytics google-analytics lucky-framework privacy
0.2.0 Latest release released
91 13 18


Kindmetrics is an strictly privacy focused web analytics for your website.

Thanks to being built on Crystal, Kindmetrics is very small when compiled (~10MB) and is very fast. Faster than Elixir, Rails or java. It use very little cpu and memory and could be deployed on old machines with linux as distro.

It is built based on following ideas:

  • Simplicity
  • Privacy for both you and your visitors
  • GDPR compliant

And as a service we follow these ideas:

  • Only EU-based services used, except for DO but the servers will be on EU soil
    • If we find a better managed kubernetes service in EU than DO, with managed db, we will move.
  • No CDN for APIs, If we add cdn for the assets files it will be an EU-based one - but for now we won't.
  • We shall always force privacy-features like DNT.

And for the technical stand, we follow these ideas:

  • Small footprint (both in size and traffic)
  • As less third party dependent as possible
  • Focus on one thing only: Analytics
  • No SPA here. we focus on backend with some javascript.

Technical stuff

Kindmetrics is built on:

  • Lucky framework, on Crystal language
  • Tailwind css
  • Stimulus.js
  • Chart.js

Setting up the project

If you want to run this project for dev, like when you want to fix bugs or new features, you have to install Crystal language. You can find more info about crystal at - You can use crenv, asdf or similar. Check the details on

Kindmetrics use postgresql

When that is done, you have to setup the lucky project:

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


Kindmetrics have some tests, even if they could be more. But you can run them by:

crystal spec

And the code should be in /src and the tests in /spec


You can easily deploy this. Just clone this to your computer and run docker build . and deploy that container to your server. Kindmetrics use all lucky framework environment variables which can be seen here:

Kindmetrics is dependent on some SMTP mail server and postgresql. Be sure to have those prepared.


I am all open for any help I can get with this project.

Fork this repo, add push your changes to a new branch and create an pull request. I will review when I can. if they follow the aboves ideas and standpoints and don't go against my plans for future, which can be seen in the issues I will approve. Just add tests. Even if I have been bad on that I am trying to be better.

  github: kindmetrics/kindmetrics
  version: ~> 0.2.0
Crystal 0.35.1


Dependencies 18

  • authentic ~> 0.6.0
    {'github' => 'luckyframework/authentic', 'version' => '~> 0.6.0'}
  • bindata 1.5.5
    {'github' => 'spider-gazelle/bindata', 'version' => '1.5.5'}
  • carbon ~> 0.1.1
    {'github' => 'luckyframework/carbon', 'version' => '~> 0.1.1'}
  • clickhouse master
    {'branch' => 'master', 'github' => 'confact/'}
  • cron_scheduler
    {'github' => 'kostya/cron_scheduler'}
  • device_detector~confact ~> 0.4.0
    {'github' => 'confact/device_detector', 'version' => '~> 0.4.0'}
  • dotenv ~> 0.7.0
    {'github' => 'gdotdesign/cr-dotenv', 'version' => '~> 0.7.0'}
  • email 0.6.1
    {'github' => 'arcage/crystal-email', 'version' => '0.6.1'}
  • hashids
    {'github' => 'splattael/'}
  • ip2country
    {'github' => 'confact/ip2country'}
  • jwt ~> 1.4.2
    {'github' => 'crystal-community/jwt', 'version' => '~> 1.4.2'}
  • kilt
    {'github' => 'jeromegn/kilt'}
  • lucky ~> 0.22.0
    {'github' => 'luckyframework/lucky', 'version' => '~> 0.22.0'}
  • lucky_can
    {'github' => 'confact/lucky_can'}
  • lucky_flow ~> 0.6.3
    {'github' => 'luckyframework/lucky_flow', 'version' => '~> 0.6.3'}
  • markd
    {'github' => 'icyleaf/markd'}
  • quoted_printable
    {'github' => 'arcage/crystal-quotedprintable'}
  • referer-parser ~> 0.1.0
    {'github' => 'confact/', 'version' => '~> 0.1.0'}

Development Dependencies 0

Dependents 0

Last synced .
search fire star recently