🌟 A comprehensive collection of Hubitat drivers, apps, and bridge integrations!
Extend your Hubitat hub's capabilities with custom drivers for various smart home devices and cloud service integrations.

Connect HubSpace/Afero cloud devices to your Hubitat hub through a secure bridge server.

# Clone repository
git clone https://github.com/neerpatel/Hubitat.git

# Setup HubSpace bridge
cd Hubitat/bridge-node
npm install
npm start

📖 Full Setup Guide: docs/Hubspace.md

Install custom drivers for specific device types directly in Hubitat.

1. Navigate to Drivers Code in Hubitat admin
2. Click New Driver
3. Copy/paste driver code from Hubitat/drivers/
4. Save and create virtual device

Hubitat/
├── 📁 bridge-node/              # Node.js bridge servers
│   ├── hubspace-server.js       # HubSpace OAuth bridge
│   ├── package.json             # Node.js dependencies
│   └── ecosystem.config.js      # PM2 configuration
├── 📁 Hubitat/                 # Hubitat Groovy files
│   ├── 📁 drivers/              # Device drivers
│   ├── 📁 apps/                 # Automation apps  
│   └── 📁 Hubspace/             # HubSpace integration
├── 📁 docs/                    # Documentation
│   └── Hubspace.md             # HubSpace setup guide
├── 📁 .github/                 # GitHub workflows & templates
└── 📄 README.md                # This file

Status: ✅ Production Ready

Connect your Hubitat hub to HubSpace cloud devices including:

• Smart lights with dimming and color control
• Ceiling fans with speed and direction control
• Smart switches and outlets
• Motion and contact sensors (coming soon)

Key Features:

• 🔐 Secure OAuth proxy with PKCE authentication
• ⚡ Real-time device state synchronization
• 🚀 Easy deployment with PM2 process management
• 📊 Full Hubitat dashboard compatibility

Get Started: docs/Hubspace.md

Status: 🚧 In Development

Custom Groovy drivers for various smart home devices:

• Generic Z-Wave/Zigbee device support
• Custom protocol implementations
• Enhanced capabilities for existing devices
• Community-contributed drivers

Status: 📅 Planned

Smart home automation applications:

• Advanced scheduling and triggers
• Multi-device coordination
• Custom notification systems
• Integration helpers

Each project has its own development guidelines:

1. Create project directory under appropriate folder
2. Add documentation in docs/ProjectName.md
3. Update this README with project entry
4. Follow coding standards for the platform
5. Include setup instructions and examples

• Groovy Code: Follow Hubitat conventions and best practices
• TypeScript/Node.js: Use modern ES features and proper typing
• Documentation: Include comprehensive setup and usage guides
• Testing: Test thoroughly with actual devices when possible
• Version Control: Use meaningful commit messages and branch names

🌟 We welcome contributions to all projects! 🌟

• HubSpace: Test with HubSpace devices, improve OAuth flow
• Drivers: Submit drivers for new device types
• Apps: Create automation apps for common use cases
• Documentation: Improve setup guides and troubleshooting

Questions? Ideas? Need help?
We'd love to hear from you!

• 🐛 Bug reports: GitHub Issues
• 💬 General discussion: GitHub Discussions
• 📖 Documentation: Check our Wiki
• 🔧 Project-specific: Tag issues with project name (e.g., hubspace, drivers)

Made with ❤️ for the Hubitat and Home Automation community

Empowering local smart home control with seamless cloud integrations.

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Hubitat Hub   │◄──►│   Bridge Server │◄──►│  HubSpace Cloud │
│                 │    │   (Node.js)     │    │   (OAuth API)   │
│  ┌─────────────┐│    │                 │    │                 │
│  │   Device    ││    │  ┌─────────────┐│    │  ┌─────────────┐│
│  │  Manager    ││    │  │   Express   ││    │  │   Devices   ││
│  │             ││    │  │   Server    ││    │  │  & State    ││
│  └─────────────┘│    │  └─────────────┘│    │  └─────────────┘│
└─────────────────┘    └─────────────────┘    └─────────────────┘

Data Flow:

1. Hubitat Device Manager authenticates with Bridge Server
2. Bridge Server handles OAuth flow with HubSpace Cloud
3. Real-time device state synchronization
4. Secure command relay for device control

# Clone and setup
git clone https://github.com/neerpatel/Hubitat.git
cd Hubitat/bridge-node

# Install dependencies
npm install

# Development mode (with auto-reload)
npm run dev

# TypeScript compilation
npm run build

# Type checking
npm run type-check

Hubitat/
├── bridge-node/          # Node.js TypeScript bridge server
│   ├── src/             # TypeScript source files
│   ├── package.json     # Node.js dependencies
│   └── ecosystem.config.js  # PM2 configuration
├── Hubitat/             # Hubitat Groovy files
│   └── Hubspace/        # HubSpace device drivers
│       └── HubspaceDeviceManager.groovy
└── setup.sh            # Automated deployment script

• Automatic Device Discovery - Scans HubSpace account for available devices
• Real-time State Updates - Keeps Hubitat in sync with cloud device states
• Secure Authentication - OAuth flow handled securely through bridge
• Dashboard Integration - Full compatibility with Hubitat dashboards
• Multi-Device Support - Supports lights, fans, switches, and more

🌟 We welcome your contributions! 🌟

• Follow TypeScript best practices for bridge server
• Use Groovy conventions for Hubitat drivers
• Test thoroughly with actual HubSpace devices
• Document any new features or device support

Questions? Ideas? Need help?
We'd love to hear from you!

• 🐛 Bug reports: GitHub Issues
• 💬 General discussion: GitHub Discussions
• 📖 Documentation: Check our Wiki

Made with ❤️ for the Hubitat and Home Automation community

Bringing cloud devices to your local smart home hub, securely and efficiently.