Submit App to App Store

Submitting Your Own JavaScript Apps And Games

Welcome to the official KryonOS AppStore repository. This repository acts as the decentralized backend database powering the KryonOS App Store.

Follow these steps to submit your application or game to the KryonOS ecosystem:

Step 1: Fork the Repository

Start by forking the official repository to your own GitHub account: Fork KryonOS-AppStore

How to Fork: Click the "Fork" button at the top-right corner of the GitHub page, select your account, and click "Create fork". Once created, clone your newly forked repository onto your local computer using your terminal or Git GUI client:

git clone https://github.com/YOUR_USERNAME/KryonOS-AppStore.git

Step 2: Choose a Category

Navigate inside your locally cloned categories/ directory. Look through the existing folders to find the category that best matches your application or game (e.g., utilities, games).

Step 3: Create Your App Folder

Inside your chosen category folder, create a new subfolder. Use a clean, recognizable name for your folder that relates to your application.

Example: categories/utilities/YourAppName/

Step 4: Add Your Application Files

Inside your newly created application folder, you must include at least two core files:

• main.js — The main execution logic for your application or game.
• app.json — The metadata manifest file.

Your initial app.json should match this structure (fill in the fields to match your specific app or game):

{
  "name": "Your App Name Here",
  "packageName": "com.kryonos.yourappname",
  "version": "1.0.0",
  "metaUrl": "",
  "api": 1,
  "author": "Your Name/Team Name",
  "type": "App",
  "category": "Utility",
  "description": "A clear description of what your application or game does.",
  "changelog": "Initial release"
}

Note

• Note on the name string: The value you put inside the "name" field is what the KryonOS App Store will automatically extract and display as the public title of your application or game on the store front.
• Note on api level: You must set the "api" integer value to match the API level required by your application. To find the current KryonOS API level, check the JavaScript API Guide.
• Note on metaUrl: Leave the "metaUrl" field blank ("") or omit it. The automated system will automatically calculate and inject the correct raw URL for your application upon merge.

Step 5: Test and Open a Pull Request

Once you have thoroughly tested your application on KryonOS, follow these steps to submit your app to the main ecosystem repository:

1. Commit your changes: Save your app files, open your terminal inside the project directory, and stage your new folder:

   git add categories/

   Next, commit your changes with a clear message:

   git commit -m "feat: add YourAppName to app store"

2. Push your changes: Push the committed files directly to your forked repository on GitHub:

   git push origin main

3. Create the Pull Request: Go to the original KryonOS-AppStore repository on GitHub. You will see a banner at the top showing your recent push with a button labeled "Compare & pull request". Click it, describe your app briefly, and submit your Pull Request against our main branch.

Once verified by our maintainers, your Pull Request will be merged, and your app will immediately go live on the KryonOS App Store.

---

How to Update Your App or Game

When you want to release a new feature, bug fix, or update to an existing application, follow these steps:

1. Navigate to your existing application folder inside your forked repository.
2. Modify your main.js file with your new code updates as desired.
3. Open your app.json file and make the following critical updates:
   • Increment the version: Increase the "version" string value (e.g., change from "1.0.0" to "1.1.0"). Note: KryonOS uses this version bump to detect, fetch, and deliver the new update to users.
   • Update the changelog: Describe what changed in this version inside the "changelog" string field so users know what is new.
   • Verify API level: If your update uses newer system features, make sure to update the "api" level integer according to the latest API documentation.
4. Commit your changes, push them to your fork, and open a new Pull Request. Once merged, the store will immediately process the version increase and deploy the update.

---

Developer Documentation

Before writing code for KryonOS, please review the core development guides:

• Development Guide — Learn how to build and structure JavaScript applications for KryonOS.
• JavaScript API Guide — Learn how to access system hardware and verify system capabilities using KryonOS's JS API.
• Already Developed Apps & Games — Browse fully developed JS Apps and Games to study their app.json metadata and main.js source code as examples.