A simplified Aurora Store fork that shows ONLY whitelisted apps with automatic remote whitelist updates. Perfect for curated app distribution to specific devices or user groups.

IMPORTANT: This is a WHITELIST system - shows ONLY apps that are in your JSON list.

If your whitelist.json is empty or unreachable, NO APPS will be shown.

• Apps Tab - Displays whitelisted apps by category
• Updates Tab - Shows available updates for installed whitelisted apps
• Auto-whitelist sync - Fetches remote whitelist every 15 seconds
• Automatic UI refresh - Updates immediately when remote whitelist changes
• Smart change detection - Only refreshes when whitelist actually changes
• Smart authentication - Only prompts for login when Play Store apps are present
• External app support - Download apps from any URL without Play Store login
• Mixed app support - Combine Play Store apps with external apps

• ❌ No Play Store browsing/categories
• ❌ No app discovery or search across the entire store
• ❌ No recommendations or featured apps
• ✅ Only whitelisted apps are accessible

The repository automatically builds APKs when you push changes to the main branch:

1. Push changes to trigger build
2. Go to Actions tab in your GitHub repository
3. Download artifacts from the completed workflow

Builds are triggered by:

• Changes to .kt, .java, .xml, .gradle files
• NOT triggered by README, docs, or other non-code changes

• Java 21 (OpenJDK recommended)
• Android SDK (API level 34+)
• Git

1. Clone the repository:

git clone https://github.com/alltechdev/AuroraStore-WhitelistEdition.git
cd AuroraStore-WhitelistEdition

2. Set Java 21:

export JAVA_HOME=/path/to/jdk-21
export PATH=$JAVA_HOME/bin:$PATH

3. Build APKs:

# Debug build (for testing)
./gradlew assembleVanillaDebug

# Release build (for distribution)
./gradlew assembleVanillaRelease

4. Find built APKs:

• Debug: app/build/outputs/apk/vanilla/debug/
• Release: app/build/outputs/apk/vanilla/release/

The app fetches whitelist data from a remote JSON source. You can configure different whitelist URLs:

The app uses this default GitHub API URL:

https://api.github.com/repos/alltechdev/alltech.dev/contents/whitelist.json?ref=main

1. Fork this repository to your GitHub account
2. Create a whitelist repository with a whitelist.json file
3. Format your JSON as an array of package names:

[
  "com.example.app1",
  "com.example.app2",
  "com.another.package"
]

4. Update the default URL by modifying this line in app/src/main/java/com/aurora/store/data/providers/RemoteWhitelistProvider.kt:

var remoteWhitelistUrl: String
    get() = Preferences.getString(
        context,
        Preferences.PREFERENCE_REMOTE_WHITELIST_URL,
        "https://api.github.com/repos/YOUR_USERNAME/YOUR_REPO/contents/whitelist.json?ref=main"
    )

5. Push changes to your fork - GitHub Actions will automatically build your customized APK

Your whitelist JSON must be an array of package names with optional categories:

[
  "com.package.name1",
  "com.package.name2",
  "com.another.package"
]

[
  "com.package.name1 Productivity",
  "com.package.name2 Games",
  "com.another.package Social",
  "com.nocategory.app"
]

Category Format: "package.name CategoryName"

• Everything after the first space is the category name
• Apps without a space are placed in "Other" category
• Categories only appear in the Apps tab
• Updates tab ignores categories completely
• Categories are sorted alphabetically, with "Other" last

[
  "com.playstore.app Games",
  "Uber|com.uber.app|1.2.3|https://example.com/uber.apk|https://example.com/icon.png|Transport",
  "Signal|org.thoughtcrime.securesms|5.4.3|https://signal.org/app.apk|https://signal.org/icon.png|Social"
]

External App Format: "AppName|packageName|version|apkUrl|iconUrl|category"

• AppName: Display name (e.g., "Uber")
• packageName: Android package identifier
• version: Version string (e.g., "1.2.3") for update detection
• apkUrl: Direct download URL for APK file
• iconUrl: Direct URL to app icon (required for external apps only)
• category: Category name (optional)

External App Features:

• Download APKs from any URL (not just Play Store)
• Version checking: compares installed version vs JSON version
• Shows in Apps tab with custom name and icon
• Shows in Updates tab when newer version available
• Installation works same as Play Store apps

⚠️ Important for External Apps:

• Icon URL is required: External apps MUST include an icon URL or they will appear with blank icons (no Google Play login = no automatic icon fetching)
• No Play Store authentication needed: External apps work without Google Play login (when used exclusively)
• Mixed lists supported: You can combine Play Store apps and external apps in the same whitelist

The app has a smart authentication system that only requires login when necessary:

• No login required: If your whitelist contains only external apps, the app skips authentication entirely
• Immediate access: Users go directly to the app list without any login prompts
• Perfect for private app distribution: Ideal for enterprise or closed ecosystem deployments

• Login required when needed: When you add Play Store apps to your whitelist, the app will prompt for login
• Dynamic behavior: The login prompt appears automatically when Play Store apps are detected
• Persistent state: Once logged in, the app remains authenticated until manually logged out

Key Benefits:

• Zero friction for external-only deployments
• Automatic detection - no manual configuration needed
• Seamless transition when adding Play Store apps to existing external-only setups

1. App starts → Immediate whitelist fetch from configured URL
2. Every 15 seconds → Background fetch and comparison
3. If changes detected → Update local whitelist + emit event
4. Apps/Updates tabs receive event → Automatically refresh app list
5. User sees changes → No manual action required

This project maintains the same license as the original Aurora Store.