Folder Change Tracker with Supabase

A powerful VS Code extension that tracks file changes and git commits with automatic Supabase synchronization. Monitor your project activity in real-time with cloud storage and analytics.

✨ Features

• 📁 Real-time File Tracking: Automatically tracks file creation, modification, deletion, and renaming
• 🔀 Git Commit Monitoring: Captures git commits with detailed statistics (insertions, deletions, files changed)
• ☁️ Supabase Integration: Automatic cloud synchronization with your Supabase database
• ⚡ Auto-Sync: Real-time and periodic synchronization (every 5 minutes)
• 📊 Analytics Dashboard: View comprehensive statistics and analytics
• 🎯 Smart Filtering: Track specific folders and file types
• 💾 Local Storage: Data is stored locally and synced to cloud
• 🔧 Easy Setup: One-click Supabase configuration

🚀 Quick Start

1. Install the Extension

• Search for "Folder Change Tracker with Supabase" in VS Code Extensions
• Click Install

2. Set Up Supabase Database

1. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
2. Type: Setup Supabase Database
3. Follow the instructions to create your database tables

3. Start Tracking

1. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
2. Type: Start Tracking Folder Changes
3. Select the folder you want to track
4. Start coding! Changes will be tracked automatically

📋 Available Commands

🗄️ Database Schema

The extension creates two main tables in your Supabase database:

Changes Table

• id: Primary key
• timestamp: When the change occurred
• type: Type of change (created, modified, deleted, renamed)
• file_path: Path to the changed file
• old_path: Previous path (for renamed files)
• size: File size in bytes
• content: File content (for small text files)
• folder_path: Tracked folder path

Commits Table

• id: Primary key
• hash: Git commit hash
• author: Commit author
• date: Commit date
• message: Commit message
• files_changed: Number of files changed
• insertions: Lines added
• deletions: Lines removed
• folder_path: Tracked folder path

🔧 Configuration

Supabase Setup

1. Create a Supabase project at supabase.com
2. Get your project URL and anon key
3. Use the "Configure Supabase Database" command to set them up

Auto-Sync Settings

• Real-time sync: Changes are synced immediately when detected
• Periodic sync: Automatic sync every 5 minutes
• Manual sync: Use commands to sync on demand

📊 Viewing Your Data

In Supabase Dashboard

1. Go to your Supabase project dashboard
2. Navigate to "Table Editor"
3. View the changes and commits tables
4. Use filters and search to analyze your data

In VS Code

• Use "View Tracked Changes" to see file changes
• Use "View Tracked Commits" to see git commits
• Use "View Supabase Statistics" for analytics

🛠️ Development

Prerequisites

• Node.js 16+
• TypeScript 4.9+
• VS Code 1.74+

Building

npm install
npm run compile

Packaging

npx vsce package

📝 License

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

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

🐛 Issues

Found a bug? Have a feature request? Please open an issue.

📈 Analytics & Privacy

• All data is stored in your own Supabase database
• No data is sent to external services except your configured Supabase instance
• You have full control over your data
• Analytics are generated from your local project data

🔗 Links

• GitHub Repository
• Supabase
• VS Code Marketplace

Made with ❤️ for developers who want to understand their coding patterns and productivity.