What is Oviora Builder?

Oviora Builder is focused on one clear goal: make native Android app development easier to start on low-spec Windows PCs without opening the heavy Android Studio GUI.

oviora create MyApp
cd MyApp
oviora br

br means Build + Run.

Current Versions

Part	Version
CLI Core	`v0.2.0-safe-sync`
NPM Package	`oviora-builder@1.0.2`
Windows Installer	`v1.0.0`
Release Tag	`v1.0.0-windows-installer`

The NPM package version, CLI internal version and Windows Installer version may be released separately.

Two Ways to Use Oviora

NPM CLI Version

Best for developers who already have Node.js, Java JDK, Android SDK, ADB and Gradle installed.

npm install -g oviora-builder

Windows Installer Version

Best for beginners and fresh Windows systems. It is intended to set up a portable Android development environment.

Download Windows Installer (.exe)

Current Working Commands

System

oviora
oviora doctor
oviora status

Project

oviora create MyApp
oviora create MyApp --package com.example.myapp
oviora sync

Build

oviora build
oviora run
oviora br
oviora restore
oviora restore --force

Core Project Rule

oviora/ = source of truth
app/src/main/... = generated output

Users should mainly edit files inside oviora/. The generated Android output lives inside app/src/main/.

Sync Mapping

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

Project Folder Structure

MyApp/
├── oviora.config.json
├── settings.gradle
├── build.gradle
├── gradle.properties
├── oviora/
│   ├── layout/
│   │   ├── activity_main.xml
│   │   ├── header.xml
│   │   └── bottom_navigation.xml
│   ├── java/
│   │   └── MainActivity.java
│   ├── images/
│   ├── values/
│   │   ├── colors.xml
│   │   └── styles.xml
│   ├── firebase/
│   │   └── google-services.json
│   └── README.txt
├── .oviora/
│   └── backups/
└── app/
    └── src/main/... generated Android project

Safe Sync System

Mirror sync: deleted files in oviora/ are deleted from generated output.
Backup before sync inside .oviora/backups/.
No dangerous auto-restore during build.
Use oviora restore only when default files are needed again.

Native Android Identity

Oviora uses Java, XML, Android SDK, Gradle and ADB. It does not use the Flutter engine, React Native bridge, Cordova WebView or Capacitor WebView.

Firebase and Native Feature Status

Supported Now

Custom package name
google-services.json sync
Manual Firebase Google Sign-In test project
Manual native tests for notification, camera, microphone and location

Planned Commands

oviora add firebase
oviora add google-login
oviora add camera
oviora add notification
oviora add microphone
oviora add location
oviora build release-apk
oviora build aab