bench get-app https://github.com/alaiy-tech/alaiy_os

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=alaiy-tech%2Falaiy_os)](https://frappegems.com/gems/apps/alaiy-tech/alaiy_os)

Alaiy OS

A clean, minimal Frappe v16 / ERPNext v16 app that provisions a self-contained Alaiy OS workspace environment on install and keeps it reconciled on every bench migrate.

The app uses only Frappe's supported hooks and APIs. It does not monkey-patch Frappe internals, fake the sidebar via the DOM, or inject global UI overrides.

What it provisions

On after_install and after_migrate (alaiy_os/setup/install.py):

1. Roles — Alaiy OS Manager and Alaiy OS User.
2. Workspace — Alaiy OS, with links/shortcuts rebuilt from code each run (the app is the source of truth — manual UI edits are overwritten on migrate).
3. DocType permissions — Custom DocPerm records reconciled two-way (added for new target DocTypes, removed for ones dropped from the list).
4. Standard workspace restrictions — Alaiy OS roles stripped from standard ERPNext workspaces so they don't appear in the sidebar for Alaiy OS users.
5. Login redirect — the admin user's home_page is set to /app/os.

Access control — three layers

1. home_page DB field — redirects Alaiy OS users on login.
2. boot_session hook — filters the sidebar boot data to only Alaiy OS.
3. public/js/route_guard.js — intercepts client-side navigation and redirects Alaiy OS users back to /os.

All three explicitly bypass System Manager and Administrator.

Install

bench get-app alaiy_os /path/to/alaiy_os
bench --site  install-app alaiy_os
bench --site  migrate
bench build --app alaiy_os

Structure

alaiy_os/
├── hooks.py
├── setup/install.py                 # all provisioning logic
├── setup/boot.py                    # boot_session + on_session_creation
├── public/images/logo-square.png    # app icon
├── public/js/route_guard.js         # client-side route protection
├── public/css/core.css          # scoped styles (no global overrides)
└── workspace/Alaiy OS/Alaiy OS.json # workspace fixture for version control