Skip to content

🚀 Submit Integration to HACS Default Repository #1

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

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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