Metadata-Version: 2.4
Name: DotfileSync-cli
Version: 1.0.2
Summary: A TUI that manages your dotfiles (.bashrc, .vimrc, etc.) — lets you snapshot current config, switch between named profiles (e.g., "work", "home", "minimal"), and diff profiles side by side.
Author-email: MadushanakaRajapaksha <MadushankaRajapaksha999@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/MadushankaRajapaksha/DotfileSync
Project-URL: Repository, https://github.com/MadushankaRajapaksha/DotfileSync
Project-URL: Documentation, https://github.com/MadushankaRajapaksha/DotfileSync#readme
Project-URL: Changelog, https://github.com/MadushankaRajapaksha/DotfileSync/releases
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: textual>=0.1.0
Requires-Dist: rich>=10.0.0
Dynamic: license-file

# 📂 DotfileSync

#### *stop manually copying your configs. Switch environments in a heartbeat* 

`DotfileSync` is a lightweight, Python-powerd TUI that manages your configuration files using *Symbolic Links*. Whether your moving from your office desk to switching from "Work Mode" to "Gaming Mode", this tool swaps your `.gitconfig`, and `.vimrc` instantly.

# ✨Why use this?

Most of dotfile managers are either too simple(manual copuing) or too complex.

DotfileSync sits right in the middle:
 - *Profile Based* : Create Profiles like `work`,`home` like.
 - *safe by design* : automaticaly backups ur exsits files before touching them.
 - *Zero Logic Loss* : your files stay where they are. app just change where OS looks for Them
 - Built-in Editor: Tweak your settings directly inside the app.
# 🚀 Getting Started

### 1. Installation
Once the package is published to PyPI, anyone can install it with a single command:
```
pip install DotfileSync-cli
```

 

## 📖 Simple App Guide
### 1. Launch the App
Open your terminal and type:
```
dotSync
```
You’ll see a clean dashboard with your Profiles and Files.

### 2. Create a Profile
- Click "Add Profile".
- Give it a name (like Work or Home).
- This creates a safe folder to store those specific settings.

### 3. Add Your Files
- Choose the file you want to manage (e.g., .bashrc).
- The app takes a copy and keeps it safe inside your profiles.
 
### 4. Activate & Link (The Magic)
- Select your profile (e.g., Work).
- Click "Link Profile".
- What happens? Your computer is now "pointing" to the settings inside that specific profile.

### 5. Revert to Normal
If you want to stop using the app and go back to exactly how things were:
- Click "Unlink Profile".
- We remove the links and put your original files back where they belong.

## 🛡️ A Note for Windows Users
If you're on Windows, make sure you have Developer Mode enabled in your settings. This allows Python to create symbolic links without needing to run as Administrator every single time.
# 🤝 Contributing
Contributions are welcome! If you find a bug or want a new feature, open an issue or submit a PR.
