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:

npm start

Building for Production

Build for your platform:

# 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___