GitHub Integration

Import product files directly from GitHub repositories — including private repos.

Why Use GitHub Import?

If your team maintains product catalogs or equipment lists in a GitHub repository, you can import Excel files directly without downloading them first. This is useful for:

• Shared equipment lists maintained by your organization
• Version-controlled product catalogs
• Automated workflows where files are updated in a repo

Setup: Create a GitHub Token

1. Go to GitHub Token Settings
2. Click Generate new token
3. Name it (e.g., "AVstackr Import")
4. Set expiration (recommended: 90 days)
5. Under Repository access, select the repos containing your product files
6. Under Permissions > Repository permissions, set Contents to Read-only
7. Click Generate token and copy it

Save Your Token

1. In AVstackr, go to Settings
2. Find the GitHub Integration panel
3. Paste your token and click Save

Your token is encrypted and stored securely. It is never exposed to the browser.

Import a File

1. Go to Import Products
2. Select GitHub as the import source
3. Enter the Repository Owner (username or org), Repository Name, Branch (defaults to main), and File Path (e.g., data/products.xlsx)
4. Click Fetch & Analyze

Troubleshooting

Security

• Requests are locked to api.github.com only
• Token is encrypted at rest (AES-256)
• The token only grants access you already have on GitHub
• Use fine-grained tokens scoped to specific repos for least-privilege access
• You can clear the token from Settings at any time