Developer Guide

Everything you need to create apps, games, and themes for NautilusOS.

Getting started

1. Create a new repository under your account with your project name.
2. Add your project files there. For HTML apps, include an index.html; for themes, a .css file; for embedded apps, follow the constraints below.

Making a theme

Copy the base style from the NautilusOS repo’s style.css into your own [themename].css and customize it.

Making an app

HTML app

• Standard HTML/CSS/JS in your own folder. Can import external scripts, but keep them safe.
• Not supported offline.

Embedded app

• Rendered from JS within NautilusOS; works offline.
• No external scripts/styles; follow built-in theme classes.

Catalog info

Create an appinfo.json (or equivalent) with:

[
{
"name": "",
"desc": "",
"icon": "fas fa-icon-here",
"author": "",
"url": "" // optional for themes
}
]

Deploying for testing

Use Netlify or Vercel for quick previews. Grab the deployment URL and place it in url when applicable.

Submitting

1. Open an issue in the community repo with details and checks.
2. Expect a reply within hours to a few days with next steps.

Tip: See Browse to preview how your catalog entry will render.