NeatStep AI — Transform chaos into clarity

Inspiration

Your computer starts clean. Then life happens: downloads, screenshots, code, invoices, memes—all piled together. The real enemy? Decision fatigue. Humans waste energy asking “Where does this go?” instead of focusing on meaningful work. Most file managers still think in extensions and folders, not in purpose. So we asked: What if your files organized themselves?

What It Does?

NeatStep AI is your AI-powered digital curator:

  • Smart Organization: Scans folders recursively and maps file relationships.
  • Gemini-Powered Reasoning: Uses content understanding, metadata analysis, and semantic classification to categorize files intelligently—not just by extensions.
  • Intuitive Taxonomy: Builds clean 1–2 level folder hierarchies automatically.
  • Intelligent Renaming: Turns IMG_4021.png into meaningful names based on context inferred by Gemini.
  • Safe Automation: Detects junk, empties ghost folders, and previews changes.
  • Natural Language Control: Processes commands like “Sort by month” or “Move invoices to Finance” using Gemini’s reasoning to adjust behavior.

We make sure all operations run locally, keeping your data private and secure.

How We Built It?

  • React 19 + TypeScript, Tailwind CSS for UI.
  • Google Gemini API for cognitive file understanding.
  • File System Access API for safe, atomic operations.
  • IndexedDB for audit logs and persistence.
  • Recharts for real-time analytics dashboards.

Challenges

We faced several challanges while creating this app:

  • Browser Security: Ensuring the app doesn’t violate Google’s traffic and permission policies.
  • File Access: Managing permission requests and access limitations while interacting with the local file system.
  • Security Integration: Embedding safe, atomic operations while keeping user data private and intact.
  • Performance Trade-offs: Balancing execution speed with directory size—big folders meant smarter batching and patience..

What’s Next?

We can add the following features to enhance it's productivity:

  • Duplicate detection, version rollback.
  • Semantic search, scheduled cleanups, cloud sync.
  • Desktop packaging and team workspaces.

Built With

Share this project:

Updates