@owdproject/core 3.1.1 → 3.1.2

package/README.md

@@ -8,9 +8,9 @@
 
 ## Overview
 
-Open Web Desktop (OWD) is a framework designed to provide a simple environment for building web-based desktop experiences. It's built with Vue.js & TypeScript, and it leverages the extensible Nuxt.js architecture.
+Open Web Desktop (OWD) is a framework designed to provide a simple environment for building web-based desktop experiences. It's built with TypeScript on top of the Nuxt.js framework.
 
-[Demo](https://atproto-os.pages.dev/) · [Documentation](https://owdproject.org/)
+[Demo](https://atproto-os.pages.dev/) · [Community](https://discord.gg/zPNaN2HAaA) · [Documentation](https://owdproject.org/)
 
 ## Features
 
@@ -44,80 +44,46 @@ pnpm run generate
 
 ## Extend your desktop
 
-Open Web Desktop can be extended with themes, modules and applications.
+Thanks to Tailwind and PrimeVue, you can create custom themes from scratch and ensure a consistent look across all apps. Each theme defines its own style, making your desktop both cohesive and uniquely yours.
 
-### Install an application
+[Applications](https://github.com/topics/owd-apps) · [Modules](https://github.com/topics/owd-modules) · [Themes](https://github.com/topics/owd-themes)
 
-You can install a new [application](https://github.com/topics/owd-apps) with:
+### 🧩 Install an application
+
+You can discover new apps by searching for the [owd-apps](https://github.com/topics/owd-apps) tag on GitHub.
+
+For example, to install the To-do app:
 
 ```bash
-pnpm install @owdproject/app-todo
+nx run desktop:install-app --name=@owdproject/app-todo
 ```
 
-Then, define it in the desktop configuration:
-
-```typescript
-// desktop/owd.config.ts
-export default defineDesktopConfig({
-    theme: "@owdproject/theme-win95",
-    apps: [
-        "@owdproject/app-about",
-        "@owdproject/app-todo", // define here the app you just installed
-    ],
-    modules: []
-})
-```
+This will install the package and automatically register it in your desktop configuration.
+
+### 🧩 Install a module
 
-### Install a module
+You can discover new modules by searching for the [owd-modules](https://github.com/topics/owd-modules) tag on GitHub.
 
-You can install a new [module](https://github.com/topics/owd-modules) with:
+For example, to install the session persistence module:
 
 ```bash
-pnpm install @owdproject/module-pinia-localforage
+nx run desktop:install-module --name=@owdproject/module-pinia-localforage
 ```
 
-Then, define it in the desktop configuration:
-
-```typescript
-// desktop/owd.config.ts
-export default defineDesktopConfig({
-    theme: "@owdproject/theme-win95",
-    apps: [
-        "@owdproject/app-about",
-        "@owdproject/app-todo",
-    ],
-    modules: [
-        "@owdproject/module-pinia-localforage", // define here the module you just installed
-    ]
-})
-```
+### 🖥️ Themes
 
-## Themes
-You can install a new [theme](https://github.com/topics/owd-themes) in the same way.
+Themes are full desktop environments that style all UI components independently using [PrimeVue](https://primevue.org/).  
+Each theme provides a unique look and feel while maintaining consistent functionality across all applications.
 
-```bash
-pnpm install @owdproject/theme-gnome
-```
+You can discover new themes by searching for the [owd-themes](https://github.com/topics/owd-themes) tag on GitHub.
 
-Define the theme in `owd.config.ts`:
-
-```typescript
-// desktop/owd.config.ts
-export default defineDesktopConfig({
-    theme: "@owdproject/theme-gnome", // define here the theme you just installed
-    apps: [
-        "@owdproject/app-about",
-        "@owdproject/app-todo",
-    ],
-    modules: [
-        "@owdproject/module-pinia-localforage"
-    ]
-})
+```bash
+nx run desktop:install-theme --name=@owdproject/theme-gnome
 ```
 
 ## Sponsors
 
-Make this project sustainable, your support is crucial to keep it moving forward.
+Be the first to support this project and help us keep it growing! [Sponsor the project](https://github.com/sponsors/owdproject)
 
 ## License
 

package/bin/owd.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+
+import { spawn } from 'child_process';
+
+const [, , cmd, pkgName, ...rest] = process.argv;
+
+const commandMap = {
+  "install-app": "desktop:install-app",
+  "install-module": "desktop:install-module",
+  "install-theme": "desktop:install-theme",
+};
+
+if (!commandMap[cmd]) {
+  console.error(`Unknown command: ${cmd}`);
+  process.exit(1);
+}
+
+if (!pkgName) {
+  console.error("Missing package name (e.g., @owdproject/package)");
+  process.exit(1);
+}
+
+const nxArgs = ["run", commandMap[cmd], `--name=${pkgName}`, ...rest];
+
+const child = spawn("pnpm", ["nx", ...nxArgs], {
+  stdio: "inherit",
+  shell: true,
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owdproject/core",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "keywords": [
     "web",
     "desktop",
@@ -24,6 +24,9 @@
   },
   "type": "module",
   "types": "types/index.d.ts",
+  "bin": {
+    "owd": "./bin/owd.js"
+  },
   "dependencies": {
     "@nuxt/kit": "^3.17.2",
     "@nuxt/fonts": "^0.11.3",