Skip to content

jimmy-lan/habits-cli

Repository files navigation

Habits CLI

Author: Jimmy Lan

In this article, we will go over some high-level details of this repository.

We will explore:

View this documentation on a website.

Quick Start

Using Habits CLI · Contributing to Habits CLI · Why Habits CLI?

Using Habits CLI

Please view these guides in order:

Contributing to Habits CLI

Please navigate to the Onboard this Project section below.

Thank you for your interest in contributing to the Habits CLI!

Announcements

  • Habits CLI v0.2-alpha release testing is currently in progress and will be concluded by 22:00 on October 4th, 2021 (EDT).
  • If you encounter an issue during testing, please open an issue. If you wish to stay anonymous, please contact Jimmy (@lanyanxiang). We will create the tickets for you as a result. Have fun testing!

Overview

View this documentation on a website.

Purpose

The habits application seeks to help individuals build up healthy habits.

Background

Based on existing psychological research, one feels more motivated when the reward of keeping healthy habits and completing daily tasks is quantified. Further, one's desire to complete a TODO item might become higher when some randomness of rewards is involved.

The habits app

The habits application allows individuals to define custom digital properties. Users may use the application to reward themselves with digital properties whenever they achieve goals, complete tasks, etc. Optionally, the user may also deduct some digital assets whenever they perform bad habits. The user may define the exchange rate between digital properties and real-world items.

The habits CLI

Before I turn this README.md text that you randomly found on GitHub into an academic paper, let's talk about the Habits command-line interface. (Let me assure you, this is not a school project. As we know, I always like to find some weird reasons when I want to code some stuff in my leisure time XD)

The Habits CLI allows one to use the Habits app from the command line (isn't this obvious? :D). It is especially useful for developers or people using their command lines who do not want to switch to a browser or pick up their phone.

Running simple commands such as habits transaction add and habits property update, individuals can apply rewards to themselves without leaving their comfortable command line window. The data will be synced across all Habits app clients (e.g., mobile app and web app).

Manuals and Logs

View this documentation on a website.

09/06/2021 Update: Release plan for v0.2-alpha has been published! Please see this page for more information :D

09/30/2021 Update: Change logs for v0.2-alpha has been published! Please navigate to this page for more information.

Please refer to the most updated change logs and testing manuals for more information.

License and Contribution Note

View this documentation on a website.

This repository is released under the GNU General Public License v3.0. Please find more information in the file named LICENSE or LICENSE.md in the root repository.

You are always free to use or modify this code in your own project(s), if applicable, as long as you follow the terms and conditions outlined in the LICENSE file described above.

It is your responsibility to properly read and understand the terms and conditions from the license file prior to using any part, or parts, of code from this repository.

Onboard this Project

View this documentation on a website.

If you don't find the set-up process intuitive enough, please have a look at this setup guide. Joining or extending a project may be a challenging experience for some. That's why I aim to provide a good documentation so that you can get up to speed regardless of your prior experience. Please read some more documentation pages in the documentation site if you require further support.

Commands

View this documentation on a website.

?> You might need to use the commands below extensively throughout your contribution to this project. Therefore, I strongly encourage you to become familiar with them as soon as possible.

Set up project

npm install

Build CLI

npm run build

Start CLI build

npm start

Start documentation site

npm run doc

Please look at package.json for other available scripts.