An AI-powered file organizer that scans your folders, proposes smart renames and moves, and lets you apply or undo changes with one click. Nothing is ever permanently deleted — everything goes through a quarantine system first.
- Scan any folder and see file proposals
- AI-suggested renames and folder moves
- Apply changes in one click
- Undo last 3 batches
- Full AI confidence scoring
- Natural-language rules ("move all invoices to Finance")
- Full undo history
- Insights and storage analytics
- Duplicate file detection
- Document explainer
- Scheduled scans
- Quarantine management
- Bulk operations
- Priority support
| Layer | Technology |
|---|---|
| Framework | Next.js 16.3 (App Router) |
| Language | TypeScript 5.7 |
| Styling | Tailwind CSS v4 |
| Components | shadcn/ui + base-ui |
| AI | Gemini API (via Google Cloud Run) |
| Auth | Demo session (localStorage) |
| Icons | Lucide React |
| Package manager | pnpm |
- Node.js 18+
- pnpm
npm install -g pnpmcd mini-manager-app
pnpm installpnpm devOpen http://localhost:3000 in your browser.
pnpm build
pnpm startmini-manager-app/
├── app/
│ ├── (auth)/ # Login, signup, forgot password
│ ├── (app)/ # Main app shell (sidebar + topbar)
│ │ ├── overview/ # Dashboard
│ │ ├── organize/ # File scan + proposals
│ │ ├── insights/ # Analytics + duplicates (Pro)
│ │ ├── safety/ # History + quarantine (Pro)
│ │ ├── notifications/
│ │ ├── settings/
│ │ └── upgrade/
│ ├── onboarding/ # First-run flow
│ └── globals.css
├── components/
│ ├── layout/ # Sidebar, TopBar, AI panel, page transition
│ └── ui/ # Reusable UI components
├── lib/
│ ├── demo-data.ts # Mock file library
│ ├── heuristics.ts # Rule-based file classification
│ ├── session.ts # Auth helpers
│ └── types.ts # Shared TypeScript types
└── public/ # Logos and static assets
No permanent deletion — files are always moved to a Quarantine folder, never deleted. Users can restore anything at any time.
Confidence buckets — AI proposals are split into three tiers:
auto(≥0.85) — safe to apply without reviewreview(0.70–0.85) — worth a quick look before applyinginput(<0.70) — needs user decision
Plan gating — Pro features show a lock icon in the sidebar and redirect to the upgrade page. Free users always see what's available to them without feeling blocked.
AI chat panel — accessible via the Sparkles icon in the top bar. Supports text and voice input (Web Speech API). Slides in as an overlay so it doesn't push the main content.
- Real filesystem access via File System Access API (Chrome/Edge)
- Gemini API integration for live AI classification
- Tauri v2 wrapper for full native desktop support
- Scheduled scans
- Cloud Run backend for rules compilation and document explainer
- Real auth (Supabase or Firebase)
Private — all rights reserved.