Skip to content

amitwinit/SQLite-DevTools-Mobile-ReactNative

 
 

Repository files navigation

ADB SQLite DevTools

Inspect SQLite databases on Android devices. Browse tables, view schemas, and run SQL queries — all from your browser.

Quick Start (npm)

npm install --save-dev adb-sqlite-viewer
npx sqlite-viewer

Opens a local server at http://127.0.0.1:8085 with the full UI and ADB bridge built in. One command, no extra downloads.

# Custom port
npx sqlite-viewer --port 3000

Requirements: adb on your PATH (Android SDK Platform-Tools) and a USB-connected Android device with debugging enabled.

All Options

npm Package (Recommended for dev workflows)

Install into any project and run alongside your app:

npm install --save-dev adb-sqlite-viewer

Add to your package.json scripts:

{
  "scripts": {
    "sqlite-viewer": "sqlite-viewer"
  }
}

Then npm run sqlite-viewer opens the viewer. Works great alongside React Native, Flutter, or any Android project.

Desktop App

ADB is bundled — no Android SDK required. Double-click to launch.

Platform Download
Windows ADB-SQLite-DevTools-win.exe
macOS (Apple Silicon) ADB-SQLite-DevTools-mac-arm64.dmg
macOS (Intel) ADB-SQLite-DevTools-mac-x64.dmg
Linux ADB-SQLite-DevTools-linux.AppImage

macOS Gatekeeper: The app isn't signed with an Apple Developer certificate, so macOS will show "ADB SQLite DevTools is damaged and can't be opened". After dragging it to Applications, run this once in Terminal to allow it:

xattr -cr "/Applications/ADB SQLite DevTools.app"

Then open normally. The app is not actually damaged — macOS just rejects unsigned apps downloaded from the web by default.

Hosted Version + ADB Bridge

Use the deployed version at amitwinit.github.io/SQLite-DevTools-Mobile-ReactNative together with the standalone ADB Bridge.

  1. Download the bridge for your platform from Releases:
    • Windows: adb-bridge.exe
    • macOS: adb-bridge-macos
    • Linux: adb-bridge-linux
  2. Run the bridge binary
  3. Open the hosted website — it auto-detects the bridge
Website (HTTPS) ──HTTP──> localhost:15555 (bridge) ──> adb shell ──> Device

Hosted Version with WebUSB (No install required)

Open amitwinit.github.io/SQLite-DevTools-Mobile-ReactNative in Chrome/Edge. Uses WebUSB to talk directly to the device — no server needed.

Note: Requires adb kill-server first (WebUSB and ADB can't share the USB interface). Not suitable when you need ADB running for development.

When to Use Which

Scenario Recommended
Active development (React Native, Flutter, etc.) npx sqlite-viewer or Desktop App
Quick one-off DB inspection WebUSB (hosted version)
CI or shared dev environment npx sqlite-viewer
No Node.js installed Desktop App or WebUSB

Development

npm install
npm run dev          # Vite dev server
npm run build        # Build for GitHub Pages
npm run electron:dev # Build + launch Electron app
npm run electron:build # Build Electron installer

License

MIT

Packages

 
 
 

Contributors

Languages

  • JavaScript 36.8%
  • HTML 34.0%
  • Python 28.8%
  • Other 0.4%