Skip to content

adityajhakumar/-NoteFlow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 

Repository files navigation


About NoteFlow

NoteFlow is a dynamic, mood-based productivity application that revolutionizes how you manage tasks and maintain focus.

🎯 The Problem

Traditional to-do apps are boring and don't account for your mental state. You need:

  • ✅ Task management that adapts to your mood
  • 🎵 Music that enhances your productivity
  • ⏰ Proven time management techniques
  • 🎮 Gamification to stay motivated

💡 The Solution

NoteFlow combines a to-do list, Pomodoro timer, and mood-based music player into one seamless experience, helping users manage tasks effectively while staying in the zone.

🏆 Achievement

Ranked #9 globally on Product Hunt with 4,000+ users on launch day!



Core Features





**Smart To-Do Lists**

📝 Add, edit, organize tasks
🎯 Set priorities & due dates
🏷️ Categorize by project
✨ Drag & drop reordering
📊 Progress tracking




**Focus Enhancement**

⏰ Built-in Pomodoro technique
⚙️ Adjustable work/break times
🔄 Auto-start breaks
📈 Session tracking
🔔 Notification alerts




**Adaptive Soundscape**

🎼 Mood-based playlists
🔊 YouTube integration
🎹 Multiple genres
🎧 Lofi, Classical, Jazz
🎨 Custom playlists




**Stay Motivated**

🏆 Achievement system
📊 Progress streaks
🎯 Daily goals
⭐ Points & rewards
🔥 Productivity insights




**Writing Helper**

✍️ AI-powered suggestions
📝 Task descriptions
🎯 Smart prioritization
💡 Productivity tips
🔍 Quick search




**Modern Design**

🌓 Dark/Light themes
📱 Fully responsive
⚡ Lightning fast
🎯 Intuitive interface
✨ Smooth animations


How It Works

🎯 Three-Step Productivity Flow





**Choose Your Vibe**

😊 Select your current mood
🎵 System picks matching music
🎨 UI adapts to your state
✨ Optimized environment




**Plan Your Work**

📝 Add tasks for the day
🎯 Set priorities & deadlines
📊 Organize by category
⏰ Start Pomodoro timer




**Execute & Complete**

⏳ Work in focused sprints
🎵 Music enhances flow
✅ Check off completed tasks
🏆 Earn achievements

🔄 The NoteFlow Experience

Select Mood → Curated Music Plays → Add Tasks → Start Pomodoro
                                  ↓
Check Tasks ← Take Breaks ← Stay Focused ← Music Enhances Flow


Screenshots

📸 App Interface


NoteFlow Screenshot 1


Clean interface with task lists and mood selector
NoteFlow Screenshot 2


Integrated music player with timer controls

Key UI Highlights


Installation & Setup

📋 Prerequisites

🚀 Quick Start



git clone https://github.com/
adityajhakumar/-NoteFlow.git

cd NoteFlow

Clone the project
to your local machine



npm install
# or
yarn install
# or
pnpm install

Install all required
packages and dependencies



npm run dev
# or
yarn dev
# or
pnpm dev

Start the app on
http://localhost:3000

⚙️ Environment Configuration

# Create .env.local file in root directory

# Add your environment variables
NEXT_PUBLIC_YOUTUBE_API_KEY=your_youtube_api_key
NEXT_PUBLIC_FIREBASE_API_KEY=your_firebase_key
# ... other configurations

🔧 Build for Production

# Create optimized production build
npm run build

# Start production server
npm start


Tech Stack

🛠️ Built With Modern Technologies


🎨 Frontend


Frontend Stack



UI Framework

App Framework

Styling

Type Safety

⚙️ Backend & Tools


Backend Stack



Backend/Auth

Deployment

Icons

Music Integration

📦 Key Libraries


Product Hunt Success

🏆 Launch Metrics




#9



Worldwide Position
Out of thousands of launches


4,000+



First Day Users
Organic growth without ads


⭐⭐⭐⭐⭐



Community Loved
Positive feedback & reviews

Product Hunt


Future Roadmap

🚀 Phase 1: Core Enhancements


🔐 User Authentication

Implement Firebase authentication for saving tasks across devices. Enable cloud sync for seamless experience.



🎵 Advanced Music Algorithms

Enhance music recommendation system based on productivity patterns and user preferences.



📊 Analytics Dashboard

Add productivity insights, completion rates, and time tracking visualizations.

🌟 Phase 2: Advanced Features


👥 Team Collaboration

Shared task lists, team Pomodoro sessions, and collaborative goal tracking.



📱 Mobile Apps

Native iOS and Android applications with offline support and push notifications.



🤖 AI Task Suggestions

Machine learning-powered task prioritization and smart scheduling recommendations.


Usage Tips

🎯 How to Get the Most Out of NoteFlow

1. Start with Mood Selection

  • Choose your current emotional state
  • Let NoteFlow adjust the environment
  • Music will automatically match your vibe

2. Plan Your Day

  • Add all tasks for the day
  • Set realistic priorities
  • Organize by urgency and importance

3. Use Pomodoro Effectively

  • Work in 25-minute focused sprints
  • Take 5-minute breaks between sessions
  • After 4 Pomodoros, take a longer 15-30 minute break

4. Leverage Music Integration

  • Different genres for different tasks
  • Lofi for focused work
  • Classical for creative tasks
  • Upbeat for energizing activities

5. Review and Adjust

  • Check completed tasks regularly
  • Adjust priorities as needed
  • Celebrate your progress!
⚡ Keyboard Shortcuts
Shortcut Action
Ctrl/Cmd + N New Task
Ctrl/Cmd + Enter Complete Task
Space Play/Pause Music
Ctrl/Cmd + Space Start/Stop Pomodoro
Ctrl/Cmd + M Toggle Mood Selector
Ctrl/Cmd + , Settings


License & Usage

📜 Proprietary License




© 2025 Aditya Kumar Jha. All rights reserved.

This software is proprietary and closed-source. Unauthorized copying, 
modification, distribution, or commercial use of this project is 
strictly prohibited without explicit written permission.

For licensing inquiries, please contact: adityajha29092004@gmail.com

⚠️ Important Notice

  • No Unauthorized Use — This project cannot be copied or modified without permission
  • No Commercial Use — Commercial usage requires a separate license
  • No Distribution — Redistribution is strictly prohibited
  • Personal Use Only — You can run the app locally for personal exploration
  • Feedback Welcome — Suggestions and bug reports are appreciated


Contributing

🤝 Contribution Policy




Currently, this project is not open for contributions due to

About

NoteFlow is a dynamic mood-based to-do list and productivity tool that helps users manage tasks, use a Pomodoro timer, and listen to music based on their mood.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors