Skip to content

Zohaib8090/codeoss-android

Repository files navigation

CodeOSS Android

A fully standalone, native IDE for Android. No PC. No Termux. No compromises.

Built by @Zohaib8090


What is CodeOSS Android?

CodeOSS Android is a full development environment that runs entirely on your Android phone. Unlike other mobile code editors, it doesn't require Termux, a remote server, or a PC. Everything runs natively on-device.

Clone a repo, install npm packages, and run a dev server β€” all from your phone.


Installation

  1. Download the latest APK from Releases
  2. On your Android phone, go to Settings β†’ Security β†’ Install unknown apps and allow your browser or file manager
  3. Open the downloaded APK and tap Install
  4. Open CodeOSS Android and start coding

Minimum requirements: Android 10+, arm64-v8a device (most modern Android phones), ~500MB free storage


Features

Editor

  • Multi-file Tabs β€” Open multiple files simultaneously with unsaved change indicators
  • Split Screen β€” View and edit files side by side horizontally or vertically
  • Syntax Highlighting β€” Color highlighting for Kotlin, JavaScript, TypeScript, HTML, CSS, Markdown and more
  • Smart Keyboard β€” Extra keys row (ESC, TAB, arrows, CTRL) that sits above the soft keyboard

Terminal

  • Real Terminal β€” Full PTY-based terminal powered by the termux-terminal-emulator library
  • Multiple Sessions β€” Run multiple terminal sessions simultaneously with tab switching
  • ANSI Support β€” Full color and cursor control support
  • TUI Support β€” Interactive CLI tools render correctly

Git & Source Control

  • Git over HTTPS β€” Clone, commit, push, pull via libgit2 JNI bridge (no binary execution)
  • GitHub OAuth β€” Sign in with GitHub β€” no manual config needed
  • Source Control UI β€” Visual git panel with commit, push, pull, branch switching, changes list and timeline
  • One-click Clone β€” Browse your GitHub repos and clone with a single tap

Runtime

  • Node.js Runtime β€” Full Node.js running on-device
  • npm Support β€” Install packages and run scripts natively
  • Auto Binary Updates β€” Node.js and Git binaries update automatically via GitHub releases

Browser & DevTools

  • Built-in Browser β€” Open your dev server directly inside the IDE
  • Auto Detection β€” Automatically detects running dev servers and offers to open them
  • DevTools Console β€” Browser console showing logs from your web app
  • Desktop Mode β€” Switch between mobile and desktop user agent
  • Camera/Mic/File β€” Full permission support for testing web apps
  • Zoom Support β€” Pinch to zoom and text size controls

Port Forwarding

  • One-tap Tunnels β€” Expose localhost to the internet instantly via bore.pub
  • Auto Detection β€” Automatically detects active dev server ports
  • Open Anywhere β€” Open tunneled URLs in internal or external browser

Debugging

  • Debug Console β€” Variables, Watch, Call Stack, Breakpoints panel
  • Live Logcat β€” Real-time system log viewer with filtering and color coding
  • Problems Panel β€” Automatically parses build errors with file and line info
  • Output Panel β€” Dedicated output view for running tasks

Marketplace & Extensions

  • Extension Marketplace β€” Browse and search VS Code extensions via Open VSX
  • Extension Details β€” Full description, publisher info and version for each extension

Project Management

  • File Manager β€” Full file explorer with create, rename, delete, copy, paste, cut
  • Project Import/Export β€” Import and export projects as ZIP files
  • File Upload/Download β€” Upload files from device storage into projects

Updates & Settings

  • Auto Update Notifications β€” Get notified when a new app version is available
  • Configurable Font Size β€” Adjust editor and terminal font size
  • Configurable UI Scale β€” Adjust icon and UI element sizes
  • Zero Termux Dependency β€” Completely standalone APK
  • Android 15 Compatible β€” Works with Android's W^X security policy

Supported Frameworks

Framework Status Notes
React + Vite βœ… Working Use @vitejs/plugin-react (not swc)
Express / Node.js βœ… Working Full support
Vue + Vite βœ… Working Pure JS build
Svelte + Vite βœ… Working Pure JS build
Next.js ⏳ Pending Blocked by missing SWC binary for Android arm64. Track progress

Architecture

CodeOSS Android
β”œβ”€β”€ Kotlin / Jetpack Compose (UI)
β”œβ”€β”€ JNI Bridge (native-lib.cpp)
β”‚   β”œβ”€β”€ PTY Bridge (forkpty β†’ real terminal)
β”‚   β”œβ”€β”€ Git Bridge (libgit2 β†’ HTTPS clone/push/pull)
β”‚   └── DNS Override (Google DNS for Node.js)
β”œβ”€β”€ Terminal Engine (termux-terminal-emulator)
β”‚   └── Full VT100/xterm emulation
β”œβ”€β”€ Bundled Binaries (jniLibs/arm64-v8a)
β”‚   β”œβ”€β”€ libnode.so (Node.js runtime)
β”‚   β”œβ”€β”€ libgit2.so (Git operations)
β”‚   β”œβ”€β”€ libcurl.so (HTTP/HTTPS)
β”‚   β”œβ”€β”€ libssl.so / libcrypto.so (OpenSSL 3.x)
β”‚   └── libicui18n/uc/data.so (Unicode support)
└── Zero-Termux Policy (no external dependencies)

Known Limitations

Limitation Reason Status
Next.js not supported No SWC binary for Android arm64 Reported to Next.js
Use @vitejs/plugin-react not swc Same SWC issue Workaround available
No iOS support Platform limitation Not planned
x86 devices not supported All binaries are arm64-v8a Not planned

Roadmap

  • Terminal with PTY
  • Git clone over HTTPS
  • GitHub OAuth login
  • npm install
  • Vite + React support
  • Built-in browser with DevTools
  • Port forwarding (bore.pub)
  • Multi-file tabs + split screen
  • Source control UI
  • Debug console + Logcat
  • Extension marketplace UI
  • Auto update notifications
  • Node/Git binary update system
  • Termux terminal emulator integration
  • Syntax highlighting
  • Smart keyboard row
  • LSP autocomplete (downloadable language packs)
  • AI assistant (bring your own API key)
  • Android app development support
  • Next.js support (pending SWC Android arm64)

Found a Bug?

Open an issue on GitHub.


For Developers β€” Building from Source

This section is only for developers who want to modify or build CodeOSS Android. Regular users just need the APK above.

Prerequisites:

  • Android Studio Hedgehog or newer
  • Android NDK r25+
  • CMake 3.22+
  • JDK 17+

Steps:

git clone https://github.com/Zohaib8090/codeoss-android.git
cd codeoss-android
./gradlew assembleDebug

APK will be at app/build/outputs/apk/debug/app-debug.apk


License

MIT License β€” see LICENSE for details.


Acknowledgements

  • libgit2 β€” Git operations
  • Termux β€” Binary sources and terminal emulator library
  • Node.js β€” JavaScript runtime
  • bore β€” Port forwarding
  • Open VSX β€” Extension marketplace

Made with ❀️ by a 17-year-old developer from Karachi, Pakistan

If CodeOSS Android helps you, consider sponsoring

About

πŸš€ CodeOSS Android: The Lightweight Vibe-Coding IDE CodeOSS Android is a professional-grade, high-performance IDE built for the next generation of mobile-first developers. Unlike heavy web-wrappers, it provides a native experience optimized for arm64 devices,

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors