TaskFlow

TaskFlow is a clear, beginner-friendly, open-source To-Do List web application built using HTML, CSS, and Vanilla JavaScript. It is designed to be straightforward and self-contained with no frameworks or libraries required.

This project was created specifically to give first-year (FY) students hands-on experience with real-world open-source contributions.

Table of Contents

• Project Overview
• Tech Stack
• Features
• Folder Structure
• Getting Started
• How to Contribute
• License

Project Overview

TaskFlow is part of a student chapter open-source event. The core purpose of the project is to provide a reliable sandbox where contributors can pick up issues, fix bugs, add new features, and submit pull requests in a structured environment.

Every great developer starts with their first contribution, and this project serves as a starting point.

Tech Stack

TaskFlow relies purely on web fundamentals:

• HTML5: Application structure and semantic markup
• CSS3: Styling, dark mode, and responsive design
• Vanilla JavaScript (ES6+): Application logic, DOM manipulation, and LocalStorage data persistence

By avoiding complex frameworks, build tools, or package managers, the application can be opened and run directly in any web browser.

Features

• Add, complete, and delete tasks
• Filter tasks by status (All, Active, Completed)
• Track pending tasks count
• Dark mode toggle
• Data persistence using LocalStorage
• Fully responsive design for mobile and desktop screens

Folder Structure

The project follows a standard and modular structure:

/
├── index.html
├── package.json
├── IMPLEMENTATION.md
├── ISSUES.md
└── assets/
    ├── css/
    │   ├── style.css
    │   ├── dark-mode.css
    │   └── responsive.css
    ├── icons/
    └── js/
        ├── app.js
        ├── tasks.js
        ├── filter.js
        ├── storage.js
        ├── darkMode.js
        └── utils.js

Getting Started

To run the application locally on your machine:

1. Clone the repository to your local machine using Git.
2. Navigate to the project directory.
3. Open index.html in your preferred web browser.

There are no dependencies to install or build steps to run. The application runs natively in the browser.

How to Contribute

Contributions are welcome. Please refer to the ISSUES.md and IMPLEMENTATION.md files for more details on open issues, contribution guidelines, coding standards, and commit message formats.

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes in the appropriate files within the assets/ directory.
4. Test your changes locally to ensure the app works as expected.
5. Commit your changes with a descriptive message.
6. Submit a Pull Request summarizing the changes and referencing any related issues.

Contact

If you have any questions, feel free to reach out:

• Name: Aavishkar Chaudhari
• GitHub: aavishkarchaudhari
• Email: aavishkar.chaudhari24@pccoepune.org

License

This project is licensed under the MIT License. See the package.json file for author and license details.