FDHub Repository

Welcome to our automated F-Droid binary repository! This repository automatically fetches and publishes open-source Android apps directly from their original GitHub releases, ensuring you always get the latest, unmodified APKs directly from the developers.

📱 How to Use (Add to F-Droid)

To install these apps on your Android device, you need an F-Droid client (like F-Droid, Neo Store, or Droid-ify).

Add the following repository URL to your client:

https://fdhub-mt.netlify.app/repo

Once added, the apps will appear in your catalog and automatically receive updates!

---

🤝 How to Add a New App (Submit a PR)

Want to see your favorite open-source GitHub app in this repository? Anyone can add a new app by submitting a Pull Request!

1. Fork this repository.
2. Create a new JSON file inside the apps/ folder. The file name must be the exact Android Package ID of the app (e.g., org.example.app.json).
3. Fill in the app details using the simple template below.
4. Submit a Pull Request to this repository.

Once your PR is merged, the automated system will instantly pick up the app, download its latest release, and publish it to the F-Droid repository for everyone!

App Configuration Template

Here is a minimal configuration example. Just change the id, name, and github fields:

{
  "id": "com.github.developer.appname",
  "name": "My Favorite Open Source App",
  "github": "developer/repository-name",
  "assets": {
    "include": ["*.apk"],
    "exclude": ["*-debug.apk", "*-unsigned.apk"]
  },
  "metadata": {
    "summary": "A short one-line description of the app",
    "description": "A longer description of the app explaining its features.",
    "categories": ["Productivity"]
  }
}

Note: The system only tracks official GitHub Releases. The app must attach pre-compiled .apk files to their GitHub Releases to be supported.

---

Deploy (Netlify)

The public F-Droid front door is hosted on Netlify. Index/entry/icon are served from Netlify; APK paths use _redirects 302 to each app’s official GitHub Release asset (no APK re-hosting).

One-time setup

Already done for this repo:

• Netlify site: fdhub-mt → https://fdhub-mt.netlify.app
  (fdhub was unavailable; project is linked locally)
• GitHub Actions secrets: NETLIFY_AUTH_TOKEN, NETLIFY_SITE_ID

Confirm after the first successful workflow deploy:

1. https://fdhub-mt.netlify.app/repo/index-v2.json returns 200
2. https://fdhub-mt.netlify.app/repo/<apk-file-name> returns 302 to the upstream Release URL
3. Disable or ignore the old GitHub Pages site so clients use the Netlify URL only.

Scheduled updates and generate.yml both publish with:

netlify-cli deploy --prod --dir=generated