Skip to content

README.md

Latest commit

 

History

History
103 lines (74 loc) · 3.38 KB

README.md

File metadata and controls

103 lines (74 loc) · 3.38 KB

🚀 Zeeshan's App Hub

React Native Next.js Supabase License: MIT

A high-performance, private APK distribution system featuring a sleek, Glassmorphism-designed Android Client and a secure Next.js Admin Dashboard. This platform allows Zeeshan to securely upload, manage, and install private Android applications without making files public.

✨ Features

📱 Android Application (Client)

  • Glassmorphism UI: Stunning transparent aesthetics with floating background orbs and premium shadows.
  • Smart Tracking: Background download progress that persists even if you dismiss the view.
  • Instant Installation: Automatic APK integrity checks and seamless installation via native Android intents.
  • Secure Access: Utilizes Supabase Signed URLs (100-year expiry) to keep storage buckets 100% private.
  • Dynamic Refresh: Pull-to-refresh to fetch the latest builds instantly.

🌐 Web Portal (Admin)

  • Secure Uploads: Next.js Server Actions using the Supabase Service Role Key to bypass public RLS.
  • Icon Management: Automatic icon and APK handling during the creation process.
  • Global Deployment: Optimized for Vercel/Netlify hosting.

🏗️ Project Architecture

This is a monorepo containing two main projects:

Directory Type Description
/AndroidApp React Native The mobile client for downloading and installing APKs.
/webapp Next.js The administrative dashboard for managing app data.

🛠️ Tech Stack

  • Frontend (Mobile): React Native (TypeScript), React Native Paper, Vector Icons.
  • Frontend (Web): Next.js 14, Tailwind CSS, Lucide React.
  • Backend / Storage: Supabase (PostgreSQL, Storage Buckets).
  • Tooling: Jimp (Icon Generation), LocalTunnel (Instant Public Webaccess), Git.

🚀 Getting Started

1. Prerequisites

  • Node.js (v18+)
  • Android Studio & SDK
  • Supabase Account

2. Environment Setup

Create a .env file in both directories:

AndroidApp/.env

NEXT_PUBLIC_SUPABASE_URL=your_project_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key

webapp/.env

NEXT_PUBLIC_SUPABASE_URL=your_project_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

3. Running the Projects

Running the Web Admin

cd webapp
npm install
npm run dev

Running the Android Client

cd AndroidApp
npm install
npm run android

📸 Screenshots

(Add your screenshots here to WOW your users!)

🛡️ Security

This project is built with a Security-First mindset:

  • Private Buckets: Your APKs and Icons are never public.
  • Signed URLs: The app uses temporary (but long-lived) signed tokens to download assets.
  • Service Role: Backend operations are protected by the Supabase Service Role key, which is never exposed to the client app.

Crafted by Antigravity for Zeeshan. 🌌