DevTasks ✅

A high-performance, minimalist task manager designed for developer roadmaps. DevTasks provides a premium, clean monochrome environment with fluid micro-animations, theme toggles, and state persistence to keep your engineering flow uninterrupted.

---

✨ Features

• ⚡ Ultra-Fast Performance: Built on React 19 and Vite 6 for instant reactivity and hot reloading.
• 🌓 Dynamic Themes: Seamless transitions between premium white and deep zinc dark modes.
• 🗂 Categorized Engineering Tasks: Group tasks by FEATURE, BUG, or REFACTOR with custom priority weights (HIGH, MEDIUM, LOW).
• 📊 Roadmap Analytics: Live visual progress indicators tracking your overall task completion percentage.
• 📜 System Logs & History: Dedicated recovery panel to audit and restore deleted tasks back into your roadmap.
• 📦 Robust Persistence: State stays persistent across browser reloads using LocalStorage.
• 🔔 Polished Toasts: Custom, stylized notifications powered by sonner matching the application's clean design.

---

🛠️ Tech Stack

• Core: React 19
• Styling: Tailwind CSS v4 (utility-first, pure custom tokens)
• Bundler & Dev Server: Vite 6
• Routing: React Router v7
• Notifications: Sonner
• Icons: React Icons

---

📦 Installation & Quick Start

Get your local development environment running in under 2 minutes:

1. Clone the Repository

git clone https://github.com/shamilahmdt/devtasks.git
cd devtasks

2. Install Dependencies

npm install

3. Start the Development Server

npm run dev

Open your browser and navigate to http://localhost:5173.

---

🤝 Contributing

We love open-source contributions! Whether you're a seasoned developer or looking to make your very first PR, you are welcome here.

⭐ Support the Project: If you find DevTasks helpful or are planning to contribute, please consider giving us a star! It helps others discover the project and shows your appreciation for our maintainers.

🌿 Contribution Pipeline

1. Fork the repository and clone your fork locally.
2. Create a branch for your feature:

   git checkout -b feat/your-awesome-feature

3. Commit your changes using clean, descriptive commit messages.
4. Push to your fork and submit a Pull Request targeting our main branch.

---

💬 Discussions & Community

Got a feature idea, an architectural suggestion, or just want to chat about the roadmap?

• Join the Conversations: Head over to our GitHub Discussions page.
• Pitch New Features: We love exploring new concepts! Start a discussion thread to discuss layout designs, icons, or state structures before writing code.

---

🎯 Active Beginner Issues

Ready to write some code? We actively maintain highly descriptive templates for first-time contributors. Look out for the good first issue and help wanted labels inside our GitHub Issues tracker!

💡 Featured Roadmap Tasks

Here are a few exciting features currently open for implementation:

• 🟢 Task Due Dates & Deadline Badges (Issue Template)

  • Goal: Add a date picker when adding tasks and show Due Today / Overdue alerts inside the task list.
  • Skills: Date calculations, conditional rendering.

• 🟢 Dedicated Import & Export Data Center (Issue Template)

  • Goal: Create a dedicated page for backup data transfer, dynamically sorting active, completed, and deleted logs into correct state targets.
  • Skills: LocalStorage JSON parsing, routing, validation toasts.

• 🟢 Filter Counters & Bulk Clear Action (Issue Template)

  • Goal: Render total active and completed task counts inside the filter buttons, and implement a "Clear Completed" trigger button to bulk archive tasks in one click.
  • Skills: Array lengths, array state manipulation.

• 🟢 "Undo Delete" Interactive Toast Action (Issue Template)

  • Goal: Add a functional "Undo" action trigger directly inside the task deletion toast notification using Sonner's API.
  • Skills: State rollback, interactive notification components.

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.