Skip to content

Creating an Application

tokitty edited this page Feb 1, 2026 · 3 revisions

Applications are the core of utilizing AndromedaOS.
AndromedaOS follows the MacOS Application Bundle style very closely, and uses the same folder structure.
AndromedaOS Applications are structured like this:

Your.app

Contents

AndromedaOS (Your executables)
Frameworks (Your libraries & other dependencies)
Resources (Anything else you need to run the app.)
Info.json

You may have noticed that I left Info.json undocumented. That's because it's just your standard, run-of-the-mill JSON.
Speaking of, here's an example Info.json to get you started.

{
	"PList": {
		"Name": "Boot screen",
		"Author": "tocat",
		"PackageName": "com.andromeda.hello",
		"Version": "1.0.0",
		"Entry": "AndromedaOS/hello.lua"
	}
}

The system offers some libraries in /System/Libraries/Darwin, and may have what you need to get you started. Make sure your app is in /Applications!
To test your app after it's done, you can use open <your app name, no path needed. e.g. open Boot.app> to launch your app.

Clone this wiki locally