README.md

```
# SpotSync Alpha Desktop Application

A desktop version of the SpotSync Alpha trading replication engine built with Electron.

## Features

- **Local Execution**: All processing happens on your machine
- **Enhanced Security**: API keys encrypted with local keychain
- **System Tray Integration**: Run minimized with notifications
- **SQLite Database**: Local storage for trade history and configuration
- **Custom Title Bar**: Native desktop window controls
- **Context Menus**: Right-click support throughout the application

## Installation

### Development

1. Install dependencies:
```bash
npm install
```

2. Start the application:
```bash
npm start
```

### Building for Production

Build for your platform:

```bash
# Windows
npm run build:win

# macOS
npm run build:mac

# Linux
npm run build:linux
```

## Project Structure

```
spotsync-alpha-desktop/
├── main.js                 # Electron main process
├── index.html             # Main application window
├── style.css              # Application styles
├── script.js              # Application logic
├── package.json           # Dependencies and build configuration
├── assets/                # Icons and static assets
│   ├── icon.png
│   ├── icon.ico
│   ├── icon.icns
│   └── tray-icon.png
├── components/            # Web components
│   └── desktop-header.js
└── README.md              # This file
```

## Usage

1. Launch the application
2. Configure your master API credentials (File > Settings)
3. Add follower accounts with allocation rules
4. Start the trading engine
5. Monitor activity from the system tray

## Keyboard Shortcuts

- **Ctrl/Cmd + E**: Toggle engine start/pause
- **Ctrl/Cmd + N**: Add new follower
- **Ctrl/Cmd + S**: Export logs
- **Ctrl/Cmd + 1-5**: Switch between code tabs
- **F12**: Open developer tools

## Security Notes

- API keys are encrypted and stored locally
- No data is sent to external servers
- All trading logic executes on your local machine
- You control the master API key permissions

## License

MIT
```
___METADATA_START___
{"repoId":"zizo007/spotsync-alpha-master-follower-replication-engine","isNew":false,"userName":"zizo007"}
___METADATA_END___