Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/kepabilbao67-bot/musicplayer2/llms.txt

Use this file to discover all available pages before exploring further.

NEON DJ is a fully self-contained browser-based DJ mixer — every feature lives in a single index.html file. Because of that architecture, the entire project can be wrapped into a native Android APK using Apache Cordova, and the packaging process runs completely inside GitHub Actions. You never need to install Android Studio, a JDK, Gradle, or any other build tooling on your own machine.

How the Build Works

The repository ships with a GitHub Actions workflow named “Construir APK”. The workflow watches for changes to index.html on the main branch and starts automatically whenever a push is detected. You can also trigger it manually at any time from the Actions tab in the repository. Inside the workflow, Cordova wraps index.html — along with all of its embedded Web Audio API synthesis code — into a standard Android project and produces a debug APK. The apk-build/ folder in the repository contains the Cordova project skeleton that the workflow relies on; it provides the config.xml, platform directories, and any other Cordova scaffolding needed for the build to succeed.

Trigger Summary

TriggerCondition
AutomaticPush to index.html on the main branch
ManualWorkflow dispatch from the Actions tab

Getting the APK After a Successful Build

Once the workflow finishes and shows a green ✅, the APK is available through two delivery channels:

Download from Releases

Navigate to the Releases section of the repository and open the release titled “NEON DJ - APK para Android”. Download NEON-DJ.apk directly from the release assets.

Download from Actions

Open the Actions tab, select the completed “Construir APK” run, and scroll to the Artifacts section at the bottom of the page. Download the NEON-DJ-apk archive.

About the apk-build/ Folder

The apk-build/ directory at the root of the repository holds the Cordova project skeleton used by the workflow. It provides config.xml and the platform-specific scaffolding that Cordova needs to compile the web content into an Android application. You do not need to interact with this folder directly — the GitHub Actions workflow handles everything.
The output is a debug APK. Debug builds are signed with an auto-generated debug keystore, which means they are not suitable for submission to the Google Play Store. The APK is intended for personal use and sideloading only.
Android blocks installation of APKs that don’t come from the Play Store by default. Before you can install NEON-DJ.apk, you must enable “Install from unknown sources” in your device’s Security settings. The exact path through the settings menu varies by Android version and device manufacturer.

Build docs developers (and LLMs) love