Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
MIT License

Copyright (c) 2025 mashrufmohd

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
133 changes: 133 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,133 @@
# Smart Habit Spark - Habit Tracker
Welcome to Smart Habit Spark, a habit-tracking application designed to help users build and maintain positive daily routines. This project, developed as part of my portfolio, leverages modern programming techniques to provide an intuitive and engaging way to track habits, monitor progress, and stay motivated. The application is housed in the smart-habit-spark-main directory of this repository.
About the Project
Smart Habit Spark is a user-friendly habit tracker that empowers individuals to create, track, and visualize their daily habits. Whether you're aiming to exercise regularly, drink more water, or read daily, this app helps you stay consistent with features like progress tracking and streak visualization. The project may incorporate AI-driven insights or a clean interface, inspired by platforms like GitHub Spark, to enhance user experience.
Features

Habit Creation: Add custom habits with names, descriptions, and frequency (daily, weekly, etc.).
Progress Tracking: Monitor completion streaks and view your progress over time.
User Interface: A clean, intuitive interface (assumed to be command-line or web-based, pending specific implementation details).
Data Persistence: Save habit data locally or in a database for long-term tracking.
Motivational Insights: Optional AI-powered suggestions or analytics to keep users engaged (if applicable).


**Edit a file directly in GitHub**

- Navigate to the desired file(s).
- Click the "Edit" button (pencil icon) at the top right of the file view.
- Make your changes and commit the changes.

**Use GitHub Codespaces**

- Navigate to the main page of your repository.
- Click on the "Code" button (green button) near the top right.
- Select the "Codespaces" tab.
- Click on "New codespace" to launch a new Codespace environment.
- Edit files directly within the Codespace and commit and push your changes once you're done.

## What technologies are used for this project?

This project is built with .

- Vite
- TypeScript
- React
- shadcn-ui
- Tailwind CSS


Note: The exact file structure may vary. Update this section with specific files once available.
Getting Started
Prerequisites
To run Smart Habit Spark, ensure you have the following installed:

Python 3.x (if Python-based):python --version


Required Libraries (if applicable, listed in requirements.txt):pip install -r smart-habit-spark-main/requirements.txt


Node.js (if web-based, e.g., for a React or JavaScript frontend):node --version
npm --version


A modern web browser (for web-based interfaces).

Installation

Clone the repository:
git clone https://github.com/mashrufmohdHabbit-tracker.git
cd Habbit-tracker/smart-habit-spark-main


Install dependencies:

For Python-based projects:pip install -r requirements.txt


For web-based projects (if applicable):npm install




Run the application:

For Python:python [main_script].py


For web-based (e.g., Node.js/React):npm start





Usage

Start the Application:

Run the main script (e.g., python app.py) or start the web server (e.g., npm start).
If web-based, open your browser and navigate to http://localhost:3000 (or the specified port).


Create Habits:

Add new habits via the command-line interface or web form, specifying the habit name and frequency.


Track Progress:

Mark habits as completed daily and view your streaks or progress charts.


Explore Features:

Check for analytics or motivational prompts (if implemented) to stay on track.



Example (for Python command-line):
python app.py
# Follow prompts to add habits and mark them as completed

Contributing
This project is a personal endeavor to demonstrate my development skills. Contributions are welcome in the form of feedback or suggestions! To contribute:

Fork the repository.
Create a new branch (git checkout -b feature/your-feature).
Commit your changes (git commit -m "Add your feature").
Push to the branch (git push origin feature/your-feature).
Open a pull request.

Please open an issue to discuss proposed changes before contributing.
License
This project is licensed under the MIT License - see the LICENSE file for details (if applicable).
Acknowledgments


GitHub Spark: For potential inspiration in building AI-powered or rapid-development applications.
The open-source community for tools and libraries used in this project.

Contact
For inquiries or feedback, reach out via GitHub issues or connect with me on LinkedIn.

Smart Habit Spark is a step toward building better habits through technology. Start tracking your habits today!