Native Android Java/XML Engine

Build Native Android apps
without the IDE bloat.

A lightweight CLI that generates, builds, and launches true native Java/XML Android projects on your phone. Perfect for beginners and low-spec PCs. No Android Studio required.

Get Started View on GitHub
powershell - oviora
PS> oviora doctor
√ Node, Java, ADB, and Gradle found.
PS> oviora create MyApp
Creating native Java/XML workspace...
PS> cd MyApp
PS> oviora br
> Syncing oviora/ to app/src/main/
> Building APK via Gradle...
> Installed successfully! Launching app...

Choose Your Workflow

Oviora Builder is available as a lightweight global NPM package for developers, or as an all-in-one Windows installer for complete beginners.

Developer Choice

Global NPM CLI v0.2.0

Best if you already have Node.js and Java setup. Works on Windows, Mac, and Linux.

✓ Any terminal access
✓ Mirror sync & Backups
✓ Custom package names for Firebase

Install Command:

npm install -g oviora-builder
Oviora NPM Package
Beginner Friendly

Windows Installer v1.0.0

Portable runtime. No manual Java, SDK, Gradle, or Node setup required.

✓ Portable Node.js & JDK
✓ Portable Android SDK & Gradle
✓ Auto-configures System PATH
Download EXE (Windows 64-bit)

Downloads securely from GitHub Releases

True Native Output

No Bridges. No WebViews.
Pure Android.

Unlike hybrid frameworks, Oviora Builder doesn't compromise on performance. It scaffolds a real Android Java/XML project and uses the official Gradle toolchain to compile your code. You get the exact same output as Android Studio, but with a CLI interface.

What it's NOT

  • ✕ React Native
  • ✕ Flutter
  • ✕ Cordova / Capacitor
  • ✕ WebView wrapper

What it IS

  • ✓ Native Java Logic
  • ✓ Native XML Layouts
  • ✓ Official Gradle Build
  • ✓ Authentic Android SDK
Native Project Files
Generated Native Project
App Running on Phone
Running on Device via ADB

The CLI Workflow

From zero to a running app in seconds using your terminal.

Check System

Ensure Java, Node, ADB, and Gradle are ready.

1
oviora doctor command
oviora
create MyApp
# Generates oviora/ workspace
2

Create Workspace

Generates a flat, shallow folder structure making it incredibly easy to find and edit your Java and XML files.

Build & Run

The br command syncs your workspace, builds the APK, installs it on your USB-connected phone, and launches it automatically.

3
oviora br command

Beautiful one-click installer

The Windows installer provides a self-contained runtime environment. It securely sets up Node, Java, and Android SDK components behind the scenes.

Oviora Builder Windows Installer GUI Screenshot

System Requirements

  • Windows 10/11 64-bit
  • 4GB RAM minimum (8GB recommended)
  • SSD recommended for faster Gradle builds
  • ~3GB free disk space
  • Android phone with USB debugging enabled

SmartScreen Security Notice

The Windows installer is currently unsigned. Because it is new, it does not yet have Microsoft SmartScreen reputation.

If Windows shows a warning, click:
More info → Run anyway
Complete Information

Everything a beginner should understand before using Oviora Builder

Oviora Builder is a lightweight native Android Java/XML CLI builder. It helps beginners, students and low-spec PC users create, build, install and launch real Android apps from PowerShell without opening the heavy Android Studio GUI.

What is Oviora Builder?

It creates a real native Android project, syncs your clean workspace into the Android project, builds a debug APK with Gradle, installs it with ADB and launches it on your connected Android phone.

Why it is different

It is not Flutter, React Native, Cordova, Capacitor or a WebView wrapper. The output is native Java/XML Android code powered by Android SDK, Gradle and ADB.

Best daily command

For normal development, beginners can use one command:

oviora br

1 Current Public Versions

CLI Core

0.2.0-safe-sync

NPM Package

oviora-builder@1.0.2

Windows Installer

v1.0.0

Release Tag

v1.0.0-windows-installer

2 Two Ways to Install

Windows Installer

Recommended for beginners

Includes portable Node.js, JDK, Android SDK, Gradle, ADB tools and Oviora CLI. Default location: C:\Oviora

NPM CLI

For developers
npm install -g oviora-builder

Beginner Quick Start

Install once, open a new PowerShell window, check the environment, create your app and run it on your phone.

Go to Download
01

Install

Use Windows installer or NPM global install.

02

Check

oviora doctor
03

Create

oviora create MyApp
04

Build + Run

oviora br
quick-start.ps1 
oviora doctor
oviora create MyApp
cd MyApp
oviora br

Safe Workspace Rule

Oviora uses a safe source-of-truth system. Beginners mainly edit the simple oviora/ folder, and the builder generates the real Android output.

✓ oviora/ = source of truth
→ app/src/main/ = generated output

Beginner edit files

oviora/layout/
oviora/java/
oviora/images/
oviora/values/

Advanced files

AndroidManifest.xml
app/build.gradle
build.gradle
gradle.properties

Sync Mapping

During sync, files move from the easy Oviora workspace into the correct Android project folders.

oviora/layout/ → res/layout/
oviora/java/ → java/<package>/
oviora/images/ → res/drawable/
oviora/values/ → res/values/
oviora/firebase/google-services.json → app/google-services.json

Main CLI Commands

These are the commands users should see clearly on the website.

oviora

Shows help and available commands.

oviora doctor

Checks Node, NPM, Java, ADB and Gradle.

oviora create MyApp

Creates a new native Android project.

oviora sync

Mirror syncs workspace to Android output.

oviora build

Builds debug APK with Gradle.

oviora run

Installs and launches APK on phone.

oviora br

Build + Run. Recommended daily command.

oviora restore

Restores missing default workspace files.

oviora status

Shows app, package, workspace and APK status.

System Requirements

  • ✓ Windows 10/11 64-bit
  • ✓ 4 GB RAM minimum
  • ✓ 8 GB RAM recommended
  • ✓ SSD recommended
  • ✓ Around 3 GB free disk space
  • ✓ Android phone with USB debugging

Firebase Support

  • ✓ Custom package name support
  • ✓ google-services.json sync
  • ✓ Manual Google Sign-In test support
  • ! Package name must match Firebase config
oviora create YuvaJyoti --package com.yuvajyoti
oviora/firebase/google-services.json
oviora br

Native Feature Tests

  • ✓ Google Sign-In
  • ✓ FirebaseAuth
  • ✓ Local notification
  • ✓ Camera intent
  • ✓ Microphone recording test
  • ✓ Location test

Common Problems & Quick Fixes

This section helps users solve beginner problems without opening a long README.

Full docs on GitHub →

Command not found

Open a new PowerShell window and run where.exe oviora. The portable path should appear first.

No device found

Run adb devices, enable USB debugging, reconnect USB and accept the phone permission popup.

Config not found

You are not inside an Oviora project folder. Use cd YourAppFolder then run oviora br.

APK install failed

Check USB debugging, storage, old app conflict and version downgrade. Try uninstalling the old package then run again.

Java compile error

Check missing imports, wrong variable names, wrong package line or XML IDs that do not match findViewById.

Google Sign-In error 10

Usually SHA-1 mismatch. Run signing report, add SHA-1 in Firebase Console and download fresh config.

Security Notes

Never upload private keys, service account files, keystores or environment files to public repositories, screenshots or videos.

serviceAccountKey.json
firebase-adminsdk.json
.env
*.jks / *.keystore

For public demo projects, use google-services.sample.json instead of real private config.

Roadmap

Current version supports manual native feature testing. These commands are planned for future versions:

oviora add firebase
oviora add google-login
oviora add camera
oviora add notification
oviora build aab
oviora release init
Learn More

Explore Oviora Builder Documentation

Read the full documentation, Windows Installer guide, comparison, fresh PC testing checklist, and troubleshooting guide.

Full Docs

Commands, folder structure, safe sync system, Firebase support, native feature testing, and roadmap.

Open Documentation →

Windows Installer

Portable Node.js, JDK, Android SDK, ADB, Gradle, PowerShell command setup, and installer test details.

View Installer Guide →

Comparison

Oviora Builder vs Android Studio, Flutter, React Native, and Cordova with honest positioning.

Compare Tools →

Fresh PC Test

Checklist to verify Oviora Builder on a clean Windows PC with no previous Android setup.

Open Test Checklist →

FAQ & Troubleshooting

Fix command not found, ADB device issues, APK install errors, Firebase errors, Java compile errors, and resource errors.

Open FAQ →

Best Beginner Flow

Install once, open PowerShell, run doctor, create app, and build + run using one command.

oviora doctor
oviora create MyApp
cd MyApp
oviora br