Add Tauri app skeleton and project files

Initialize the Nebula OS Tauri project: add frontend (src/) with HTML, JS, CSS and SVG assets, plus a sample greet UI. Add src-tauri Rust backend (Cargo.toml, build.rs, main/lib) with a greeting command, tauri.conf.json, capability schema and platform icons. Add package.json (dev dependency on @tauri-apps/cli), .gitignore files and VSCode recommended extensions. Expand README with project vision, architecture and phase roadmap to document the Windows-first development plan.

.gitignore

@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["tauri-apps.tauri-vscode", "rust-lang.rust-analyzer"]
+}

README.md

@@ -1,2 +1,333 @@
-# Nebula-OS
+# Nebula OS v0 – Windows-first Development Plan
 
+## Vision
+
+Nebula OS is a **controller-first, open source operating system experience** built on Linux.
+
+It has two equally important jobs:
+
+1. **A custom controller-first way to navigate the OS** (like a console shell)
+2. **An open source library and launcher layer** for games and apps
+
+Nebula OS is not a skin that launches Steam.
+It is an independent UI layer that:
+
+* Acts as the primary **controller-first shell** for the OS
+* Provides a unified Home experience for **games, apps, and media**
+* Ships with core Nebula apps such as **Nebula Browser**
+* Exposes **system settings** through controller-friendly panels
+* Manages game libraries directly (Steam, GOG, Epic, and others)
+
+Nebula OS v0 focuses on building the foundation for this console-grade OS shell.
+
+---
+
+# Core Principles
+
+1. Controller-first, not controller-compatible
+2. Replace proprietary frontends with an open interface
+3. Separate system layer from UI layer
+4. Build modular infrastructure for long-term independence
+5. Develop iteratively, but architect for autonomy
+
+---
+
+# What Nebula OS v0 Actually Is
+
+Nebula OS v0 consists of:
+
+* Base OS: Ubuntu LTS (or Ubuntu-based)
+* Desktop Environment: KDE Plasma (recommended)
+* Display Manager: SDDM
+* Two login sessions:
+
+  * Nebula Desktop
+  * Nebula Game UI
+* Nebula Shell (Tauri + HTML/CSS/JS)
+* Nebula Library (core application responsible for:
+
+  * Game discovery
+  * Installation
+  * Updates
+  * Launching
+  * Compatibility management)
+
+Unlike SteamOS, Nebula OS does not rely on launching Steam Big Picture.
+Nebula Library is the primary game management layer.
+
+---
+
+# High-Level Architecture
+
+## Desktop Mode
+
+A standard KDE session for:
+
+* Productivity workflows
+* File browsing and system tools
+* Development and troubleshooting
+* Advanced configuration
+
+Desktop Mode remains a normal Linux desktop.
+
+## Game UI Mode
+
+A dedicated login session that launches **Nebula Shell** fullscreen.
+
+Game UI Mode contains:
+
+* Lock screen with controller PIN entry
+* Nebula Home dashboard
+* Nebula Browser
+* Nebula Library
+* Controller-friendly Settings
+* Power and session controls
+
+Game UI Mode is the **console experience** for the entire OS.
+
+## System Integration Layer (behind the UI)
+
+Nebula OS needs a clean boundary between UI and system operations.
+
+Recommended approach:
+
+* A small privileged backend service (later) that exposes safe operations:
+
+  * Wi-Fi and networking
+  * Audio and output device selection
+  * Display resolution and scaling
+  * Bluetooth pairing
+  * Storage overview
+  * Power controls
+* The UI talks to that layer through a stable API
+
+v0 scope can start with non-privileged read-only data and a few safe commands.
+
+---
+
+# Technology Stack
+
+## UI Layer
+
+* Tauri
+* HTML
+* CSS
+* JavaScript
+
+Why Tauri:
+
+* Lightweight
+* Native system integration via Rust backend
+* Cross-platform development
+* Efficient resource usage
+
+## Controller Input
+
+* Web Gamepad API
+* Custom focus/navigation system
+
+Controller mappings:
+
+* D-pad / left stick: navigation
+* A: activate
+* B: back
+* Start: menu
+* Shoulder buttons: future navigation layers
+
+Keyboard mirrors controller during development.
+
+---
+
+# Nebula Shell – The OS UI Layer
+
+Nebula Shell is the **controller-first OS shell**.
+
+It is the primary interface in Game UI Mode and should feel like a console dashboard, not a desktop.
+
+Nebula Shell responsibilities:
+
+* Home dashboard (games, apps, recent activity)
+* App launcher for Nebula apps (Nebula Browser, Nebula Library, Settings)
+* System navigation (network, audio, display, storage, accounts)
+* Power menu and session switching (Game UI ↔ Desktop)
+* Notifications and downloads (later)
+* Controller-first focus navigation everywhere
+
+Nebula Shell is built with Tauri + HTML/CSS/JS.
+
+---
+
+# Nebula Library – The Game and App Management Layer
+
+Nebula Library is the **content manager** inside Nebula OS.
+
+It is not a bridge to proprietary UIs.
+It should eventually handle:
+
+* Steam installs via SteamCMD and/or open APIs
+* GOG installs via open or community tooling
+* Epic installs via open tooling (for example Legendary)
+* Proton/Wine configuration and per-title settings
+* Game launch parameters and runtime selection
+* Updates, integrity checks, and metadata
+
+Initial v0 scope:
+
+* Library UI skeleton and data model
+* Local entries (manual add)
+* Launch local executables
+* Foundation for compatibility and store backends
+
+Long-term direction:
+
+Nebula Library becomes a unified open source platform for managing games and apps.
+
+---
+
+# Development Strategy
+
+Nebula OS is developed in two environments:
+
+## Windows (Primary UI Development)
+
+Used for:
+
+* Building Nebula Shell UI
+* Implementing controller navigation
+* Designing lock screen
+* Designing Library UI
+* Building system state architecture
+
+UI and logic are platform-agnostic.
+
+## Linux VM (Integration & Replacement Layer)
+
+Used for:
+
+* Building Linux binaries
+* Session integration
+* SteamCMD integration testing
+* Proton/Wine configuration
+* System-level testing
+
+Rule:
+
+Develop UI on Windows.
+Build and test Linux features inside the VM.
+
+---
+
+# Phase Roadmap
+
+## Phase 1 – Nebula Shell (Controller Console Layer)
+
+Objective:
+Build a polished, console-grade Game UI independent of store integration.
+
+Deliverables:
+
+* Lock screen with PIN keypad
+* Home dashboard
+* Library screen (mock data)
+* Settings screen
+* Power menu
+* Controller navigation grid system
+* Fullscreen window behavior
+
+No external integrations yet.
+
+---
+
+## Phase 2 – Session Integration
+
+Objective:
+Make Nebula Shell a selectable login session.
+
+Milestones:
+
+* Nebula Game UI appears at login
+* Launches fullscreen
+* Exiting returns to login
+* Controller works reliably
+
+---
+
+## Phase 3 – Nebula Library Foundations
+
+Objective:
+Begin true replacement behavior.
+
+Milestones:
+
+* Launch local Linux games
+* Integrate Proton/Wine execution layer
+* Add SteamCMD support for installing Steam titles
+* Track installed game metadata
+* Unified library view
+
+This is where Nebula begins diverging from SteamOS.
+
+---
+
+## Phase 4 – Store Integrations
+
+Objective:
+Add real backend integration without proprietary UI.
+
+Potential directions:
+
+* SteamCMD for Steam installs
+* Legendary (Epic CLI) integration
+* Heroic backend reuse (without UI dependency)
+* OpenGOG community tools
+
+Nebula Library becomes the single UI.
+
+---
+
+# Security Strategy
+
+Game UI lock screen:
+
+* Local PIN authentication
+* Optional profile system (future)
+
+Linux account authentication remains system-level.
+
+---
+
+# What Nebula OS Is Not
+
+* Not a Steam skin
+* Not Big Picture mode
+* Not a launcher aggregator
+* Not dependent on proprietary UIs
+
+It is an open system layer that manages games directly.
+
+---
+
+# Immediate Action Plan
+
+1. Build Nebula Shell UI on Windows
+2. Implement controller navigation framework
+3. Build lock screen system
+4. Build Library UI skeleton
+5. Set up Linux VM
+6. Create Nebula Game UI login session
+7. Begin local executable launching support
+8. Research SteamCMD integration
+
+---
+
+# Success Criteria for v0
+
+Nebula OS v0 is successful when:
+
+* You can log into Nebula Game UI
+* The entire UI is controller navigable
+* Lock screen works
+* You can launch locally managed games
+* You can return to Desktop Mode
+
+From there, Nebula Library evolves into a true open source game management platform.

package.json

@@ -0,0 +1,12 @@
+{
+  "name": "nebula-os",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "tauri": "tauri"
+  },
+  "devDependencies": {
+    "@tauri-apps/cli": "^2"
+  }
+}

src-tauri/.gitignore

@@ -0,0 +1,7 @@
+# Generated by Cargo
+# will have compiled files and executables
+/target/
+
+# Generated by Tauri
+# will have schema files for capabilities auto-completion
+/gen/schemas

src-tauri/Cargo.toml

@@ -0,0 +1,25 @@
+[package]
+name = "nebula-os"
+version = "0.1.0"
+description = "A Tauri App"
+authors = ["you"]
+edition = "2021"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[lib]
+# The `_lib` suffix may seem redundant but it is necessary
+# to make the lib name unique and wouldn't conflict with the bin name.
+# This seems to be only an issue on Windows, see https://github.com/rust-lang/cargo/issues/8519
+name = "nebula_os_lib"
+crate-type = ["staticlib", "cdylib", "rlib"]
+
+[build-dependencies]
+tauri-build = { version = "2", features = [] }
+
+[dependencies]
+tauri = { version = "2", features = [] }
+tauri-plugin-opener = "2"
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+

src-tauri/build.rs

@@ -0,0 +1,3 @@
+fn main() {
+    tauri_build::build()
+}

src-tauri/capabilities/default.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "../gen/schemas/desktop-schema.json",
+  "identifier": "default",
+  "description": "Capability for the main window",
+  "windows": ["main"],
+  "permissions": [
+    "core:default",
+    "opener:default"
+  ]
+}

src-tauri/src/lib.rs

@@ -0,0 +1,14 @@
+// Learn more about Tauri commands at https://tauri.app/develop/calling-rust/
+#[tauri::command]
+fn greet(name: &str) -> String {
+    format!("Hello, {}! You've been greeted from Rust!", name)
+}
+
+#[cfg_attr(mobile, tauri::mobile_entry_point)]
+pub fn run() {
+    tauri::Builder::default()
+        .plugin(tauri_plugin_opener::init())
+        .invoke_handler(tauri::generate_handler![greet])
+        .run(tauri::generate_context!())
+        .expect("error while running tauri application");
+}

src-tauri/src/main.rs

@@ -0,0 +1,6 @@
+// Prevents additional console window on Windows in release, DO NOT REMOVE!!
+#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
+
+fn main() {
+    nebula_os_lib::run()
+}

src-tauri/tauri.conf.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://schema.tauri.app/config/2",
+  "productName": "nebula-os",
+  "version": "0.1.0",
+  "identifier": "com.user.nebula-os",
+  "build": {
+    "frontendDist": "../src"
+  },
+  "app": {
+    "withGlobalTauri": true,
+    "windows": [
+      {
+        "title": "nebula-os",
+        "width": 800,
+        "height": 600
+      }
+    ],
+    "security": {
+      "csp": null
+    }
+  },
+  "bundle": {
+    "active": true,
+    "targets": "all",
+    "icon": [
+      "icons/32x32.png",
+      "icons/128x128.png",
+      "icons/128x128@2x.png",
+      "icons/icon.icns",
+      "icons/icon.ico"
+    ]
+  }
+}

src/assets/javascript.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="32" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path fill="#F7DF1E" d="M0 0h256v256H0V0Z"></path><path d="m67.312 213.932l19.59-11.856c3.78 6.701 7.218 12.371 15.465 12.371c7.905 0 12.89-3.092 12.89-15.12v-81.798h24.057v82.138c0 24.917-14.606 36.259-35.916 36.259c-19.245 0-30.416-9.967-36.087-21.996m85.07-2.576l19.588-11.341c5.157 8.421 11.859 14.607 23.715 14.607c9.969 0 16.325-4.984 16.325-11.858c0-8.248-6.53-11.17-17.528-15.98l-6.013-2.58c-17.357-7.387-28.87-16.667-28.87-36.257c0-18.044 13.747-31.792 35.228-31.792c15.294 0 26.292 5.328 34.196 19.247l-18.732 12.03c-4.125-7.389-8.591-10.31-15.465-10.31c-7.046 0-11.514 4.468-11.514 10.31c0 7.217 4.468 10.14 14.778 14.608l6.014 2.577c20.45 8.765 31.963 17.7 31.963 37.804c0 21.654-17.012 33.51-39.867 33.51c-22.339 0-36.774-10.654-43.819-24.574"></path></svg>

src/assets/tauri.svg

@@ -0,0 +1,6 @@
+<svg width="206" height="231" viewBox="0 0 206 231" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M143.143 84C143.143 96.1503 133.293 106 121.143 106C108.992 106 99.1426 96.1503 99.1426 84C99.1426 71.8497 108.992 62 121.143 62C133.293 62 143.143 71.8497 143.143 84Z" fill="#FFC131"/>
+<ellipse cx="84.1426" cy="147" rx="22" ry="22" transform="rotate(180 84.1426 147)" fill="#24C8DB"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M166.738 154.548C157.86 160.286 148.023 164.269 137.757 166.341C139.858 160.282 141 153.774 141 147C141 144.543 140.85 142.121 140.558 139.743C144.975 138.204 149.215 136.139 153.183 133.575C162.73 127.404 170.292 118.608 174.961 108.244C179.63 97.8797 181.207 86.3876 179.502 75.1487C177.798 63.9098 172.884 53.4021 165.352 44.8883C157.82 36.3744 147.99 30.2165 137.042 27.1546C126.095 24.0926 114.496 24.2568 103.64 27.6274C92.7839 30.998 83.1319 37.4317 75.8437 46.1553C74.9102 47.2727 74.0206 48.4216 73.176 49.5993C61.9292 50.8488 51.0363 54.0318 40.9629 58.9556C44.2417 48.4586 49.5653 38.6591 56.679 30.1442C67.0505 17.7298 80.7861 8.57426 96.2354 3.77762C111.685 -1.01901 128.19 -1.25267 143.769 3.10474C159.348 7.46215 173.337 16.2252 184.056 28.3411C194.775 40.457 201.767 55.4101 204.193 71.404C206.619 87.3978 204.374 103.752 197.73 118.501C191.086 133.25 180.324 145.767 166.738 154.548ZM41.9631 74.275L62.5557 76.8042C63.0459 72.813 63.9401 68.9018 65.2138 65.1274C57.0465 67.0016 49.2088 70.087 41.9631 74.275Z" fill="#FFC131"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M38.4045 76.4519C47.3493 70.6709 57.2677 66.6712 67.6171 64.6132C65.2774 70.9669 64 77.8343 64 85.0001C64 87.1434 64.1143 89.26 64.3371 91.3442C60.0093 92.8732 55.8533 94.9092 51.9599 97.4256C42.4128 103.596 34.8505 112.392 30.1816 122.756C25.5126 133.12 23.9357 144.612 25.6403 155.851C27.3449 167.09 32.2584 177.598 39.7906 186.112C47.3227 194.626 57.153 200.784 68.1003 203.846C79.0476 206.907 90.6462 206.743 101.502 203.373C112.359 200.002 122.011 193.568 129.299 184.845C130.237 183.722 131.131 182.567 131.979 181.383C143.235 180.114 154.132 176.91 164.205 171.962C160.929 182.49 155.596 192.319 148.464 200.856C138.092 213.27 124.357 222.426 108.907 227.222C93.458 232.019 76.9524 232.253 61.3736 227.895C45.7948 223.538 31.8055 214.775 21.0867 202.659C10.3679 190.543 3.37557 175.59 0.949823 159.596C-1.47592 143.602 0.768139 127.248 7.41237 112.499C14.0566 97.7497 24.8183 85.2327 38.4045 76.4519ZM163.062 156.711L163.062 156.711C162.954 156.773 162.846 156.835 162.738 156.897C162.846 156.835 162.954 156.773 163.062 156.711Z" fill="#24C8DB"/>
+</svg>

src/index.html

@@ -0,0 +1,39 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="stylesheet" href="styles.css" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Tauri App</title>
+    <script type="module" src="/main.js" defer></script>
+  </head>
+
+  <body>
+    <main class="container">
+      <h1>Welcome to Tauri</h1>
+
+      <div class="row">
+        <a href="https://tauri.app" target="_blank">
+          <img src="/assets/tauri.svg" class="logo tauri" alt="Tauri logo" />
+        </a>
+        <a
+          href="https://developer.mozilla.org/en-US/docs/Web/JavaScript"
+          target="_blank"
+        >
+          <img
+            src="/assets/javascript.svg"
+            class="logo vanilla"
+            alt="JavaScript logo"
+          />
+        </a>
+      </div>
+      <p>Click on the Tauri logo to learn more about the framework</p>
+
+      <form class="row" id="greet-form">
+        <input id="greet-input" placeholder="Enter a name..." />
+        <button type="submit">Greet</button>
+      </form>
+      <p id="greet-msg"></p>
+    </main>
+  </body>
+</html>

src/main.js

@@ -0,0 +1,18 @@
+const { invoke } = window.__TAURI__.core;
+
+let greetInputEl;
+let greetMsgEl;
+
+async function greet() {
+  // Learn more about Tauri commands at https://tauri.app/develop/calling-rust/
+  greetMsgEl.textContent = await invoke("greet", { name: greetInputEl.value });
+}
+
+window.addEventListener("DOMContentLoaded", () => {
+  greetInputEl = document.querySelector("#greet-input");
+  greetMsgEl = document.querySelector("#greet-msg");
+  document.querySelector("#greet-form").addEventListener("submit", (e) => {
+    e.preventDefault();
+    greet();
+  });
+});

src/styles.css

@@ -0,0 +1,112 @@
+.logo.vanilla:hover {
+  filter: drop-shadow(0 0 2em #ffe21c);
+}
+:root {
+  font-family: Inter, Avenir, Helvetica, Arial, sans-serif;
+  font-size: 16px;
+  line-height: 24px;
+  font-weight: 400;
+
+  color: #0f0f0f;
+  background-color: #f6f6f6;
+
+  font-synthesis: none;
+  text-rendering: optimizeLegibility;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  -webkit-text-size-adjust: 100%;
+}
+
+.container {
+  margin: 0;
+  padding-top: 10vh;
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  text-align: center;
+}
+
+.logo {
+  height: 6em;
+  padding: 1.5em;
+  will-change: filter;
+  transition: 0.75s;
+}
+
+.logo.tauri:hover {
+  filter: drop-shadow(0 0 2em #24c8db);
+}
+
+.row {
+  display: flex;
+  justify-content: center;
+}
+
+a {
+  font-weight: 500;
+  color: #646cff;
+  text-decoration: inherit;
+}
+
+a:hover {
+  color: #535bf2;
+}
+
+h1 {
+  text-align: center;
+}
+
+input,
+button {
+  border-radius: 8px;
+  border: 1px solid transparent;
+  padding: 0.6em 1.2em;
+  font-size: 1em;
+  font-weight: 500;
+  font-family: inherit;
+  color: #0f0f0f;
+  background-color: #ffffff;
+  transition: border-color 0.25s;
+  box-shadow: 0 2px 2px rgba(0, 0, 0, 0.2);
+}
+
+button {
+  cursor: pointer;
+}
+
+button:hover {
+  border-color: #396cd8;
+}
+button:active {
+  border-color: #396cd8;
+  background-color: #e8e8e8;
+}
+
+input,
+button {
+  outline: none;
+}
+
+#greet-input {
+  margin-right: 5px;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    color: #f6f6f6;
+    background-color: #2f2f2f;
+  }
+
+  a:hover {
+    color: #24c8db;
+  }
+
+  input,
+  button {
+    color: #ffffff;
+    background-color: #0f0f0f98;
+  }
+  button:active {
+    background-color: #0f0f0f69;
+  }
+}