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.
Using Habits CLI · Contributing to Habits CLI · Why Habits CLI?
Please view these guides in order:
- Installation: click here to view;
- Usage Quick Start: click here to view;
- Other Resources: Change Logs · Demos · Release Plans · Testing Manuals.
Please navigate to the Onboard this Project section below.
Thank you for your interest in contributing to the Habits CLI!
- 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!
View this documentation on a website.
The habits application seeks to help individuals build up healthy habits.
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 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.
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).
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.
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.
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.
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.
npm install
npm run build
npm start
npm run doc
Please look at package.json
for other available scripts.