droidfiles

Minimal Termux dotfiles -- bash + vim, nothing else.

Sibling of winfiles (Windows / PowerShell) and archfiles (Arch / Hyprland / Zsh). Same philosophy, scaled down for a phone:

• Two configs only: .bashrc and .vimrc.
• No prompt frameworks, no plugin managers, no plugins.
• No sudo, no systemd, no services -- pure Termux.
• One bootstrap script. Symlinks. A package list. That's it.

Stack

Area	Choice
Shell	bash (Termux default)
Prompt	plain PS1, git branch + exit-code marker
Editor	vim (works with the tiny build)
Package	pkg (Termux's apt wrapper)

Layout

droidfiles/
|-- README.md  LICENSE  .gitignore  .gitattributes  .editorconfig
|-- install.sh  uninstall.sh  symlinks.sh
|-- pkglist.txt              # source of truth (curated)
|-- pkglist.installed.txt    # auto-snapshot written by install.sh
|-- bash/
|   |-- .bashrc
|   `-- README.md
`-- vim/
    |-- .vimrc
    `-- README.md

Install

In a fresh Termux session:

pkg install -y git
git clone https://github.com/muhbrohim/droidfiles ~/droidfiles
cd ~/droidfiles
./install.sh

(SSH URL: git@github.com:muhbrohim/droidfiles.git -- after you set up keys via ssh-keygen + gh auth login.)

install.sh is idempotent. Re-run any time.

What install.sh does

1. Verifies you are in Termux (or asks to continue anyway).
2. pkg update && pkg upgrade -y.
3. pkg install -y every line of pkglist.txt.
4. Optionally runs termux-setup-storage (prompted, only if ~/storage missing).
5. Symlinks bash/.bashrc -> ~/.bashrc and vim/.vimrc -> ~/.vimrc.
6. Smoke-tests core commands.
7. Writes pkglist.installed.txt with everything currently installed.

Post-install

exec bash -l                   # reload .bashrc

git config --global user.email "you@example.com"
git config --global user.name  "Your Name"

Optional: edit from a desktop over SSH

pkg install openssh
passwd                         # set a password
sshd                           # start the daemon (port 8022)
# from your desktop:
#   ssh -p 8022 <user>@<phone-ip>

Bash highlights

See bash/README.md for the full list. Quick taste:

• gs / gcp (safe one-command git sync with .env/large-file guard).
• mkcd, extract, bck (.vN backups), pslist, pskill.
• cdf, rgf, vf, y -- fzf/fd/rg/yazi helpers, all gated by command -v.
• Auto-upgrade ls to eza and cat to bat when installed.
• pku/pki/pkr/pks/pkl -- pkg shortcuts.
• cdstor jumps to ~/storage/shared.

Vim highlights

See vim/README.md. Zero plugins. Leader is <Space>.

Privacy

Public repo. Machine- or work-specific things live in:

• ~/.bashrc.local
• ~/.vimrc.local

Both gitignored via the **/*.local glob.

The committed config never sets a git identity for you -- by design.

Uninstall

./uninstall.sh                 # dry run
./uninstall.sh --apply         # remove the two symlinks
./uninstall.sh --apply --pkgs  # also uninstall pkglist.txt packages

Packages installed as dependencies, Termux itself, and the repo are never touched.

License

MIT. See LICENSE.