Local Setup Tool

🚀 Streamline your development workflow with integrated project configuration management

Transform how you manage development projects with automated configuration management, change set control, and seamless Git integration - all within VSCode.

✨ Overview

Local Setup Tool revolutionizes project configuration management by providing a comprehensive suite of tools directly integrated into your VSCode environment. Whether you're managing multiple projects, applying complex configuration changes, or onboarding new team members, this extension automates and simplifies your development workflow.

🎯 Key Features

📁 Project Management

• Multi-Project Support - Manage unlimited development projects from a unified interface
• Intelligent Discovery - Automatically detect and organize your local projects
• Smart Navigation - Instantly switch between projects with quick access tools
• Path Management - Keep track of project locations and dependencies effortlessly

🔄 Change Set Management

• Version Control - Track and manage configuration changes across all projects
• Smart Diff System - Preview changes before applying them with advanced diff visualization
• One-Click Rollback - Easily revert changes when needed with full rollback capability
• Batch Operations - Apply changes to multiple files simultaneously for maximum efficiency

⚡ Task Automation

• Custom Commands - Define and execute project-specific commands and scripts
• Workflow Management - Create, edit, and organize automated processes
• Smart Execution - Execute tasks with intelligent dependency handling

🗄️ Database Integration

• Persistent Storage - Secure local database storage for all configurations
• Import/Export - Backup and restore project configurations with ease
• Multi-User Support - Built-in authentication for team collaboration
• Data Management - Advanced tools for cleanup and optimization

🌐 Modern Web Interface

• Intuitive UI - Clean, modern React-based interface
• Real-Time Updates - Live status monitoring and progress tracking
• Responsive Design - Perfect experience across all screen sizes
• Dark Mode - Comfortable viewing in any lighting condition

🔗 Git Integration

• Stash Management - Import and apply Git stashes as change sets
• Advanced Diff Processing - Sophisticated Git diff parsing and application
• Branch Awareness - Context-aware operations based on current branch state

🚀 Quick Start

Installation

1. Open VSCode Extensions Marketplace (Ctrl+Shift+X)
2. Search for "Local Setup Tool"
3. Click Install on the extension by Nikunj Jain
4. Restart VSCode when prompted

Initial Setup

1. Prerequisites: Ensure Docker Desktop is installed and running
2. Launch: Click the Local Setup Tool icon in the activity bar
3. Setup: Click "Start Setup" to initialize the environment
4. Start: Use "Start Application" to launch all services
5. Access: Click "Open UI" to open the full web interface

💡 Usage Examples

Creating Your First Project

1. Open Local Setup Tool panel in VSCode
2. Start the application (if not running)
3. Click "Open UI" to launch web interface
4. Navigate to Projects → Add New Project
5. Configure project path and initial settings

Managing Change Sets

1. Create new change set for your project
2. Define file modifications using search/replace
3. Preview changes with built-in diff viewer
4. Apply changes with one-click deployment
5. Monitor results in real-time

Git Stash Integration

1. Access Import Stash feature from UI
2. Select project and target Git stash
3. Preview imported changes
4. Choose: import as change set or apply directly
5. Manage like any other configuration

🎯 Perfect For

• 🛠️ Development Environment Setup - Configure new machines in minutes
• ⚙️ Configuration Management - Maintain consistency across team members
• 🔄 Code Migration - Safely apply large-scale changes across projects
• 👥 Team Onboarding - Standardized project setups for new developers
• 🔗 Version Control Integration - Seamless Git workflow enhancement

🔒 Security & Privacy

• 🏠 Local-First - All data stays on your machine, no cloud dependencies
• 🔐 Encrypted Storage - Secure database encryption for sensitive data
• 🐳 Container Isolation - Docker provides additional security layers
• 👤 User Authentication - Built-in auth system for multi-user scenarios
• 📊 Zero Telemetry - No data collection or external communication

📋 System Requirements

📚 Documentation & Support

• 📖 Complete Documentation - Comprehensive setup and usage guides
• 🐛 Report Issues - Bug reports and feature requests
• 💬 Discussions - Community support and ideas
• 📧 Direct Support - Direct line to the developer

🏆 What's New

v1.0.0 - Initial Release

• ✅ Complete project management system
• ✅ Advanced change set functionality
• ✅ Full Git integration capabilities
• ✅ Database management tools
• ✅ Modern, responsive web interface
• ✅ Docker containerization
• ✅ Multi-user authentication

🤝 Contributing

We welcome contributions! See our Contributing Guidelines for details.

📜 License

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