Initial Commit

2026-08-15 21:59:18 +01:00
commit 101935dffb
269 changed files with 29931 additions and 0 deletions
@@ -0,0 +1,41 @@
+# Standard Stylist Theme Baseline
+
+Stylist is enabled by default in this project and is the presentation layer for all application Blade views.
+
+## Default themes
+
+- `resources/themes/frontend` — public-facing pages. The standard `/` route resolves `welcome.blade.php` from this theme.
+- `resources/themes/backend` — authenticated application, dashboard, authentication/settings UI, layouts, shared components, and Flux view overrides.
+
+The defaults are controlled by:
+
+```dotenv
+STYLIST_DEFAULT_THEME=backend
+STYLIST_BACKEND_THEME=backend
+STYLIST_FRONTEND_THEME=frontend
+```
+
+`modules_statuses.json` enables the `Stylist` module on a standard installation.
+
+## View ownership rule
+
+Do not add application Blade templates back to `resources/views`. Keep public views in the frontend theme and application/admin views in the backend theme. Module-specific theme overrides belong beneath the appropriate theme's `views/modules/{module}` tree.
+
+The root `resources/views` directory is retained only as an empty Laravel fallback location.
+
+## Assets
+
+Global compiled assets remain under `resources/css` and `resources/js`. Theme-only overrides belong under each theme's `css` and `js` directories. Tailwind scans `resources/themes/**/*.blade.php`, so classes used only inside theme views remain present in production builds.
+
+## Validation
+
+After dependencies are installed, use:
+
+```bash
+php artisan module:list
+php artisan stylist:validate frontend
+php artisan stylist:validate backend
+php artisan stylist:doctor
+php artisan test
+npm run build
+```