Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Move screenshots to assets/ for ClawHub rendering
What This Skill Does
PrivateApp is a self-hosted PWA dashboard that runs a FastAPI backend with a React/Vite frontend on your own machine. Plugin-style apps are auto-discovered on startup, and built-in apps cover system monitoring and file browsing. It runs as a systemd user service on Linux or a launchd plist on macOS.
It bundles service management, frontend build tooling, and push notification support into a single install script, so you don't have to wire those pieces together separately.
When to use it
- Monitoring CPU, RAM, and disk usage on a home server
- Browsing and sharing files from a personal machine via browser
- Receiving push notifications from self-hosted automations
- Adding a custom app plugin to a personal dashboard
- Accessing a mobile-friendly PWA on a local network from a phone
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Add a new app to my PrivateApp dashboard
- 1Creates apps/{app-id}/ directory with app.json metadata including id, name, shortcode, and icon
- 2Writes an async FastAPI router in backend/routes.py mounted at /api/app/{shortcode}/
- 3Scaffolds a React/Vite frontend in frontend/ using CSS custom properties for dark mode support
- 4Runs npm run build in the frontend directory to produce dist/
- 5Restarts the service so the app loader auto-discovers the new plugin
The new app appears on the dashboard home screen and is accessible at /app/{shortcode}/