Open Web Desktop is a project that aims to provide a simple environment to create your own web desktop, extendable through a series of modules and integrations. OWD Client is based on Vue.js 3 and TypeScript.
Check the demo of the owd-client
base repository, decked out with some modules.
- Open-source web desktop client based on Vue.js 3
- Fully extendable through app and desktop modules
- Fully extendable through pages and Vue components
- Notifications, terminal commands, multiple themes
- Vuex, Vue Router and Vue i18n implemented by default
- Vuetify.js and Moment.js implemented by default
- TypeScript and Vite support
Open Web Desktop is divided in two main repositories:
- owd-client: Open Web Desktop client, made with Vue.js 3
- owd-server: Open Web Desktop server, made with Nest.js (TBA)
Required software:
When you are ready, bootstrap a new instance by running:
npx create-owd-app <app-name>
Once the process is complete, you can start with the client development:
# Run the dev server
npm run serve
# Build for production
npm run build
OWD modules can extend your Open Web Desktop instance.
You can find some modules available for all at topics/owd-modules.
You can simply install a new module with npm install <git-link>
, unless you want to customize it.
If you are planning to customize a module, clone it into src/modules/app/<module-name>
.
Always check the README.md
, you may have to move some folders (for example "config" or "public").
Also take a look at the package.json
, there may be additional dependencies to install, or other OWD modules.
For each dependency you find listed, install it by running npm install <dependency>
in the root folder of your instance.
To load an installed module, define it under my-owd-client/client.extensions.ts
.
Be sure to add every module in the app.modules
array like the default ones:
import AboutModule from "@owd-client/core/src/modules/app/about";
import DebugModule from "@owd-client/core/src/modules/app/debug";
// installed modules
import CustomModuleSource from "./src/modules/app/custom-module/client";
import CustomModuleInstalled from "owd-custom-module/client";
export default {
app: {
modules: [
AboutModule,
DebugModule,
CustomModuleSource,
CustomModuleInstalled
]
},
...
OWD Client repository is a Yarn workspaces monorepo that includes the client boilerplate, the client core, and in the future also something else like the docs, just to keep everything in a single place.
Required software:
Once you have everything installed, clone the repository:
# Using HTTPS
git clone https://github.com/owdproject/owd-client.git
# Using SSH
git clone git@github.com:owdproject/owd-client.git
Then install all the dependencies, and run Open Web Desktop in development mode.
# Navigate to the owd-client folder
cd owd-client
# Install dependencies using yarn
yarn install
# Run OWD in development mode
yarn serve
This will bootstrap the Yarn workspaces, allowing you to run and edit both client and core packages.
If you intend to contribute to the project, please join our community chat.
Your support is essential to keep this project active.
If you find Open Web Desktop useful, please consider donating.
This project is released under the GNU GPL3 License