diff --git a/README.md b/README.md
index 7358d6e..5a22a55 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,27 @@
# Space UI Demo v2 (PHP + CSS + JS)
-## Start
-- Built-in PHP server:
- php -S localhost:8000
- then open: http://localhost:8000/index.php
+## Übersicht
+Diese Demo zeigt eine HUD-artige Navigation mit statischem Hauptmenü, kontextabhängiger Subnav, Sticky-Ressourcenleiste, Toasts und einem generischen Content-Bereich. Das HTML wird vom zentralen Entry-Point `public/index.php` zusammengesetzt, die einzelnen Bausteine liegen als Partial-Templates in `src/partials`.
-## Layout (wie besprochen)
-- Links: Hauptmenü (statisch) + unten Planetenliste
-- Rechts: Topbar + Alert (optional) + Kontextmenü (Subnav in der Mitte) + Sticky Resources + Content + Footer
-- Kontextmenü wechselt je nach Hauptmenüpunkt
+## Verzeichnisstruktur
+- `public/`: Dokumentenwurzel, in der `index.php` sitzt und auf die Assets (`assets/`) zugreift. Alles, was vom Webserver ausgeliefert wird, gehört hierhin.
+- `public/assets/`: CSS- und JS-Dateien (`style.css`, `ui.js`, `starfield.js`).
+- `src/partials/`: Menü-, Footer-, Ressourcendarstellung und Content-Renderer, die `public/index.php` inkludiert.
-## Settings (ohne Cookies)
-- Einstellungen -> Performance: Auto/Low/Medium/High (sessionStorage oder localStorage)
-- Einstellungen -> Alerts: Burst (3x) oder Loop (sessionStorage oder localStorage)
+## Layout-Highlights
+- **Sidebar**: Hauptmenü (links) mit statischem Link-Set plus optionaler Planetenliste auf der Unterseite.
+- **Topbar & Notification-Dropdown**: Anzeige, Actions & Test-Toast-Button.
+- **Subnav**: Mittig platzierte Tabs (Kontextmenü) basierend auf dem `$subnav`-Array in `public/index.php`.
+- **Ressourcenleiste**: Sticky-Komponente unterhalb der Subnav (`src/partials/ressourcen.php`).
+- **Content**: Demo-Inhalte aus `src/partials/site.php`, die Sections und Subpages simulieren.
+- **Footer**: Menü-Links und optionaler Admin-Chip, gesteuert über `$isAdmin`.
-## Demos
-- In Sidebar: "Demo: Success" / "Demo: Warning"
+## Lokale Entwicklung
+1. `cd /path/to/Space-Theme`.
+2. `php -S localhost:8000 -t public` (setzt die Dokumentenwurzel auf `public/`).
+3. Öffne `http://localhost:8000/index.php` und wechsle z. B. über `?s=build&p=demolish` die Sections.
+
+## Hinweise
+- Die PHP-Session (`session_start()`) im Entry-Point dient Flash-Toasts und Alert-Messages.
+- Die Partial-Templates erwarten die Variablen `$section`, `$sub`, `$planet` und greifen über `$partialsPath` aufeinander zu.
+- Performance-/Alert-Profile werden über `sessionStorage` bzw. `localStorage` gesteuert – die Buttons in `public/assets/ui.js` sorgen für die Visualisierung.
diff --git a/assets/starfield.js b/public/assets/starfield.js
similarity index 100%
rename from assets/starfield.js
rename to public/assets/starfield.js
diff --git a/assets/style.css b/public/assets/style.css
similarity index 100%
rename from assets/style.css
rename to public/assets/style.css
diff --git a/assets/ui.js b/public/assets/ui.js
similarity index 100%
rename from assets/ui.js
rename to public/assets/ui.js
diff --git a/index.php b/public/index.php
similarity index 95%
rename from index.php
rename to public/index.php
index 5cdab2c..2e4e2ef 100644
--- a/index.php
+++ b/public/index.php
@@ -64,6 +64,8 @@ $pageTitle = "Space UI – $section / $sub";
// Admin demo (set to true to see footer admin link)
$isAdmin = false;
+$partialsPath = __DIR__ . '/../src/partials';
+$partialsPath = __DIR__ . '/../src/partials';
?>
@@ -169,7 +171,7 @@ $isAdmin = false;
@@ -195,7 +197,7 @@ $isAdmin = false;
-
+
@@ -209,12 +211,12 @@ $isAdmin = false;
-
+