Smart Life - macOS App

A native macOS application for controlling your Tuya smart home devices. Built with Electron for Intel Mac compatibility.

🏠 Features

• Device Control: Control all your Tuya-compatible smart home devices from your Mac
• Native macOS Experience: Built with macOS design principles and native menus
• Real-time Updates: Monitor and control devices in real-time
• Secure Storage: Encrypted storage for API credentials using electron-store
• Multi-region Support: Connect to Tuya cloud servers in different regions
• Intel Mac Optimized: Specifically built and optimized for Intel-based Macs

📋 Prerequisites

• macOS 10.13 or later
• Intel Mac (x64 architecture)
• Node.js 16 or later
• npm or yarn package manager
• Tuya Developer Account (for API credentials)

🚀 Getting Started

1. Clone the Repository

git clone https://github.com/sumitduster-iMac/Smart-Life.git
cd Smart-Life

2. Install Dependencies

npm install

3. Get Tuya API Credentials

1. Go to Tuya IoT Platform
2. Create a new project or use an existing one
3. Get your API Key (Access ID) and API Secret from the project overview
4. Note your data center region (US, EU, CN, or IN)

For detailed instructions, visit: https://developer.tuya.com/en/docs/iot/download?id=Kbd668dicz9r6

4. Run the Application

Development mode:

npm start

5. Configure API Settings

1. Click the ⚙️ Settings button in the app
2. Enter your Tuya API Key and API Secret
3. Select your API endpoint region
4. Click Save Settings

🔨 Building for Distribution

Build Intel Mac Application

Build DMG installer:

npm run build:dmg

Build ZIP archive:

npm run build

The built applications will be in the dist folder.

Build Output

• Smart Life-{version}.dmg - DMG installer for easy installation
• Smart Life-{version}-mac.zip - ZIP archive containing the .app bundle

📦 Package Scripts

• npm start - Run the app in development mode
• npm run build - Build the app for Intel Mac (DMG + ZIP)
• npm run build:dmg - Build DMG installer only
• npm run pack - Package the app without creating installers
• npm run dist - Full distribution build

🔧 Configuration

Supported Device Types

The app supports various Tuya device types including:

• 💡 Smart Lights
• 🔌 Smart Plugs/Switches
• 🌡️ Thermostats
• 📷 Security Cameras
• 🔒 Smart Locks
• 📡 Sensors
• 🌀 Fans

API Endpoints

• United States: https://openapi.tuyaus.com
• Europe: https://openapi.tuyaeu.com
• China: https://openapi.tuyacn.com
• India: https://openapi.tuyain.com

🏗️ Project Structure

Smart-Life/
├── .github/
│   ├── workflows/
│   │   ├── build-dmg.yml  # Automated DMG building
│   │   └── ci.yml         # Continuous integration
│   └── FUNDING.yml        # Funding configuration
├── src/
│   ├── main.js           # Electron main process
│   ├── preload.js        # Secure IPC bridge
│   ├── renderer.js       # Renderer process (UI logic)
│   ├── index.html        # Main application UI
│   └── styles.css        # Application styles
├── assets/               # Application assets (icons, images)
├── dist/                 # Built applications
├── package.json          # Project dependencies and scripts
└── README.md            # This file

🤖 CI/CD

This project includes automated workflows for continuous integration and deployment:

Build DMG Workflow

• Triggers: Push to main, tags (v*), pull requests, manual dispatch
• Actions:
  • Builds application on macOS runners
  • Tests with Node.js 18.x and 20.x
  • Creates DMG and ZIP installers
  • Uploads artifacts for download
  • Automatically creates releases for version tags

CI Workflow

• Triggers: Push to main/develop, pull requests
• Actions:
  • Validates package.json
  • Checks JavaScript syntax
  • Verifies project structure
  • Ensures all required files are present

You can download pre-built DMG files from the Actions tab or from Releases for tagged versions.

🔐 Security

• API credentials are stored securely using electron-store with encryption
• No credentials are sent to any third-party servers except Tuya's official APIs
• All communication with Tuya APIs is done over HTTPS

🛠️ Troubleshooting

App won't start (Development)

• Ensure you have Node.js 16+ installed
• Delete node_modules and run npm install again
• Check console for error messages

"App can't be opened" or "Damaged app" on macOS

This is the most common issue for unsigned apps on macOS!

The app is not signed with an Apple Developer certificate, which causes macOS Gatekeeper to block it. This is normal and safe - the app is open source.

Quick Fix:

1. Right-click the Smart Life app in Applications
2. Select "Open" from the menu
3. Click "Open" in the security dialog
4. The app will now launch (you only need to do this once)

Alternative Fix:

# Remove quarantine attribute from the app
xattr -cr /Applications/Smart\ Life.app

For DMG mounting issues:

# Remove quarantine from downloaded DMG
xattr -d com.apple.quarantine ~/Downloads/Smart\ Life-*.dmg

Detailed Instructions: See INSTALL.md for comprehensive troubleshooting steps including System Preferences methods.

Can't connect to devices

• Verify your API credentials are correct
• Ensure you selected the correct API endpoint region
• Check that your devices are online in the Tuya/Smart Life mobile app
• Verify your Tuya project has the necessary API permissions

Build fails

• Ensure you're running on macOS (for DMG builds)
• Check that electron-builder is installed correctly
• Try cleaning the project: rm -rf dist node_modules && npm install
• Make sure icon files exist in assets/ directory

📚 Resources

• Tuya IoT Platform
• Tuya Developer Documentation
• Tuya API Reference
• Electron Documentation

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

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

🙏 Acknowledgments

• Built with Electron
• Powered by Tuya IoT Platform
• Icon design inspired by smart home aesthetics

📞 Support

For issues and questions:

• Open an issue on GitHub
• Check Tuya Developer Forum

---

Note: This application requires valid Tuya API credentials to function. Make sure to register for a Tuya developer account and create a project to obtain your credentials.