---
license: mit
tags:
  - android
  - keyboard
  - ime
  - clipboard
  - react
  - nextjs
language:
  - en
---

# CopyVault Keyboard

**Search your clipboard like you search the web.** An Android keyboard (IME) that captures everything you copy and lets you search & re-paste it from any app.

## Downloads

| File | Size | Description |
|------|------|-------------|
| [copyvault-keyboard.apk](https://huggingface.co/ryzerrr/copyvault-keyboard/resolve/main/copyvault-keyboard.apk) | 4.5 MB | Pre-built Android APK (ready to install) |
| [copyvault-full-project.zip](https://huggingface.co/ryzerrr/copyvault-keyboard/resolve/main/copyvault-full-project.zip) | 1.9 MB | Complete source: web app + Android project |
| [copyvault-full-project.tar.gz](https://huggingface.co/ryzerrr/copyvault-keyboard/resolve/main/copyvault-full-project.tar.gz) | 1.3 MB | Same, as tarball |
| [BUILD-GUIDE.md](https://huggingface.co/ryzerrr/copyvault-keyboard/resolve/main/BUILD-GUIDE.md) | — | Step-by-step build instructions |

## Install the APK

1. Download `copyvault-keyboard.apk` to your Android phone
2. Tap the file to install (enable "Install from unknown sources" if prompted)
3. Open **Settings → System → Keyboard & Input Method**
4. Enable **CopyVault Keyboard**
5. Set CopyVault as your default keyboard
6. Copy anything anywhere → it's captured to your searchable history
7. Tap any text field → use the **Clipboard** tab to search & paste

## Features

- **Searchable clipboard history** — capture everything, search by text/type/source/time
- **Smart entity detection** — URLs, emails, phones, OTPs, tracking numbers, crypto addresses, code, colors, passwords
- **Three-panel keyboard** — Clipboard / Type (QWERTY) / Emoji
- **Trapezium-shaped tabs** — sleek, unique monochrome design
- **Themes** — Light / Dark / AMOLED / System
- **Incognito mode** — stops capture when enabled
- **Snippet templates** — type `;sig` + space → expands to full signature
- **Local-only storage** — no cloud, no telemetry
- **System clipboard monitoring** — captures clips from any app

## Architecture

```
User types on keyboard
    ↓
TypingPanel → useUI.typeChar("q")
    ↓
UI store (imeMode=true) → window.AndroidKeyboard.commitText("q")
    ↓
WebAppInterface.commitText() → InputConnection.commitText()
    ↓
Text appears in the active app

User copies text anywhere
    ↓
Android ClipboardManager fires listener
    ↓
CopyVaultKeyboardService injects JS: window.__copyVaultAddClip(text, "Android")
    ↓
Zustand store adds clip to history
    ↓
Clip appears in the Clipboard panel, searchable
```

## Build from source

See [BUILD-GUIDE.md](https://huggingface.co/ryzerrr/copyvault-keyboard/resolve/main/BUILD-GUIDE.md) for complete instructions.

Quick version:
```bash
bun install
BUILD_EXPORT=true bun run build
node scripts/fix-assets.js
cp -r out/* android-keyboard/app/src/main/assets/

cd android-keyboard
echo "sdk.dir=/path/to/Android/Sdk" > local.properties
./gradlew assembleDebug
adb install app/build/outputs/apk/debug/app-debug.apk
```

## Tech stack

- **Web app**: Next.js 16, TypeScript 5, Tailwind CSS 4, shadcn/ui, Zustand, Framer Motion
- **Android**: Kotlin, InputMethodService, WebView, ClipboardManager

## Requirements

- Android 7.0 (API 24) or higher
- JDK 17 for building
- Android SDK 34 for building

## License

MIT