Skip to content

🚀 Submit Integration to HACS Default Repository #1

@rmrfslashbin

Description

@rmrfslashbin

Overview

Track the submission of the Synaccess netBooterâ„¢ integration to the HACS (Home Assistant Community Store) default repository for official inclusion.

Prerequisites

This issue is blocked until the Home Assistant Brands PR is approved:

🔄 Brands PR: home-assistant/brands#7450
📋 Tracking Issue: home-assistant/brands#7451

Current Readiness Status

✅ Repository Requirements

  • Public GitHub repository
  • Repository description added
  • GitHub topics configured
  • Issues enabled
  • Comprehensive README with usage info
  • MIT License

✅ Code Requirements

  • Valid manifest.json with all required fields
  • Proper hacs.json configuration
  • GitHub Actions (hassfest + HACS validation)
  • GitHub releases created
  • No pre-commit hook failures

✅ Integration Quality

  • Working integration tested on hardware
  • Proper Home Assistant entity structure
  • Device grouping with DeviceInfo
  • Error handling and logging
  • Dynamic outlet count support

HACS Submission Process

Once brands PR is merged:

  1. Fork https://github.com/hacs/default
  2. Add entry to integrations.json (alphabetically sorted):
    {
      \"domain\": \"netcommander\",
      \"repository\": \"rmrfslashbin/netcommander\"
    }
  3. Create PR from new branch (not master)
  4. Follow PR template requirements
  5. Wait for automated validation and review

Expected Timeline

  • Brands PR: Months (high review volume)
  • HACS PR: Weeks to months (also high volume)

Review Criteria

HACS will verify:

  • ✅ Brands repository inclusion
  • ✅ Integration passes hassfest validation
  • ✅ HACS validation passes
  • ✅ Repository not archived
  • ✅ Has GitHub releases
  • ✅ Submitter is repository owner/contributor
  • ✅ Repository has description and topics
  • ✅ Proper JSON formatting and sorting

Benefits of HACS Default Inclusion

  • 📦 Easy Discovery: Users find integration in HACS store
  • 🔄 Automatic Updates: HACS manages version updates
  • 👥 Community Reach: Broader adoption and testing
  • 📊 Usage Statistics: Better visibility of adoption

Current Integration Version: v2.1.1
Tested Device: Synaccess netBooterâ„¢ Model NP-0501DU

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions