Web App Skeleton

Web App Skeleton provides a complete starter template for building custom web apps and extensions for ownCloud Infinite Scale. It includes a pre-configured development environment with Docker Compose, Vite build tooling, unit testing with Vitest, and a working example extension -- giving developers everything they need to quickly scaffold and develop new oCIS web applications.

Part of oCIS

This repository is part of the ownCloud Infinite Scale (oCIS) developer ecosystem. It serves as the official starting point for third-party extension development, integrating with the ownCloud Web extension system.

As a template repository, extensions scaffolded from this skeleton can be bundled into an oCIS deployment image once developed.

Getting Started

Follow the steps below to scaffold and develop a new oCIS web application.

Prerequisites

• Docker and Docker Compose
• pnpm (check packageManager field in package.json for the correct version)

Development Environment

git clone https://github.com/owncloud/web-app-skeleton.git
cd web-app-skeleton
pnpm install && pnpm build:w

Add to /etc/hosts:

127.0.0.1 host.docker.internal

Start the development server:

docker compose up

Open https://host.docker.internal:9200 (default login: admin/admin).

Customize Your App

Rename skeleton to your app name in:

• package.json
• vite.config.ts
• dev/docker/ocis/apps.yaml
• src/index.ts
• tests/unit/App.spec.ts

Testing

pnpm test:unit             # Run unit tests (Vitest)

Production Build

pnpm build                 # Build for production (output in dist/)

Documentation

• Web Extension System Documentation
• Web App Deployment Guide
• Web Developer Documentation
• awesome-ocis Publishing Guide

Community & Support

Star this repo and Watch for release notifications!

• ownCloud Website
• Community Discussions
• Matrix Chat
• Documentation
• Enterprise Support
• OSPO Home

Contributing

We welcome contributions! Please read the Contributing Guidelines and our Code of Conduct before getting started.

Workflow

• Rebase Early, Rebase Often! We use a rebase workflow. Always rebase on the target branch before submitting a PR.
• Dependabot: Automated dependency updates are managed via Dependabot. Review and merge dependency PRs promptly.
• Signed Commits: All commits must be PGP/GPG signed. See GitHub's signing guide.
• DCO Sign-off: Every commit must carry a Signed-off-by line:

  git commit -s -S -m "your commit message"
  

• GitHub Actions Policy: Workflows may only use actions that are (a) owned by owncloud, (b) created by GitHub (actions/*), or (c) verified in the GitHub Marketplace.

Security

Do not open a public GitHub issue for security vulnerabilities.

Report vulnerabilities at https://security.owncloud.com -- see SECURITY.md.

Bug bounty: YesWeHack ownCloud Program

License

This project is licensed under the Apache-2.0.

About the ownCloud OSPO

The Kiteworks Open Source Program Office, operating under the ownCloud brand, launched on May 5, 2026, to steward the open source ecosystem around ownCloud's products. The OSPO ensures transparent governance, license compliance, community health, and sustainable collaboration between the open source community and Kiteworks, which acquired ownCloud in 2023.

• OSPO Home: https://kiteworks.com/opensource
• GitHub: https://github.com/owncloud
• ownCloud: https://owncloud.com

For questions about the OSPO or licensing, contact ospo@kiteworks.com.

License status: This repository is already licensed under Apache-2.0 -- the OSPO target license. No migration is required.