Caution
🚨 ALPHA STATUS: This project is currently in early alpha and requires more testing before production use. Bugs are expected, and features may change. Contributors are very welcome!
OneFeather is designed to be a comprehensive, open-source alternative to proprietary ecosystems like Google Workspace or Microsoft 365. Built specifically for Small and Medium Enterprises (SMEs) and Startups, OneFeather provides all the essential tools your team needs to collaborate effectively—without the vendor lock-in or recurring per-user fees.
By hosting OneFeather on your own Virtual Private Server (VPS), you get:
- Complete Data Sovereignty: Your data stays on your servers. No third-party data mining or privacy concerns.
- Cost Efficiency: Flat hosting costs instead of expensive monthly per-seat subscriptions.
- All-in-One Collaboration: Documents, chat, tasks, and files unified in a single, modern interface.
OneFeather bundles the core applications every team needs to succeed:
- 🔗 Universal Interlinking (The Core Feature): Deeply connect your entire workspace. You can mention and link pages, files, people, and tasks across all applications. Everything stays in sync with real-time updates, creating a truly unified ecosystem.
- 📝 Real-time Collaborative Documents: Edit documents simultaneously with your team. Powered by CRDTs, you get a seamless, Google Docs-like experience.
- 🖋️ Full Office Suite (OneDocs · OneSheets · OneSlides): A complete word processor, spreadsheet, and presentation app built into the workspace — with native .docx/.xlsx/.pptx export. Office files live in your Drive, are shareable with access rights, and hook into mentions, notifications, and Tasks. See below ↓
- 💬 Team Chat: Instant messaging for quick communication without leaving your workspace.
- ✅ Task Management: Keep track of projects, assign tasks, and monitor progress.
- 📁 File Storage: Centralized file management for all your company's assets.
- 🔔 Notifications: Stay up to date with mentions, task assignments, and document changes.
- 🛡️ Admin Dashboard: Manage users, permissions, and workspace settings easily.
- 🌓 Beautiful UI with Dark Mode: A modern, sleek interface with full light and dark mode support.
OneFeather ships a real office suite — not embedded viewers. OneDocs (word processor), OneSheets (spreadsheet), and OneSlides (presentations) are zero-build, browser-native editors that are first-class citizens of the workspace:
| OneDocs — word processor | OneSheets — spreadsheet |
|---|---|
 |
 |
| OneSlides — presentations | Create from Files or the sidebar |
|---|---|
 |
 |
Workspace integration
- Drive-native files — create documents, spreadsheets and decks from the + New menu or the sidebar; they appear in My Drive / Shared / Recent / Starred, live in folders, and can be moved, starred, copied and trashed like any node.
- Sharing with access rights — the standard Share dialog works on office files: per-user, per-group, workspace-wide or link access with viewer / commenter / editor / manager roles, changeable at any time. Enforcement is server-side; viewers get a read-only mode.
- @mentions in comments — mention a teammate in a document comment and they get a notification and access to the file, exactly like Pages.
- Checklists ↔ Tasks — a
@namein a OneDocs checklist item assigns it as a task in that person's task list. Checking the box in the document completes the task; completing (or reopening) the task updates the document. Both directions, automatically. - Live title & content sync — documents autosave to the server through
/api/office/:id/content; open copies pick up remote changes by polling.
Editor depth (each app is a full implementation, ~5k lines of dependency-free JS)
- OneDocs: styles & outline, tables, images, footnotes, TOC/index/bibliography, equations (LaTeX), tracked changes (suggesting mode), comments, mail merge, form controls, charts, watermarks, page setup, version history, password-encrypted documents (AES-GCM), export to .docx, EPUB, Markdown, HTML.
- OneSheets: ~110 formula functions with dynamic arrays & spilling, cross-sheet refs, named ranges, conditional formatting (color scales, data bars), filters, sort, pivot summaries, charts, frozen panes, 50k-row virtualized canvas grid, import/export .xlsx & CSV.
- OneSlides: themes, layouts, shapes/tables/charts, animations with Morph transitions, presenter console with audience-window sync, grid & outline views, export .pptx, PNG and JSON.
Each app also works standalone (they're static files under web/public/apps/ — open index.html and go); of-bridge.js adds the workspace binding when opened from the shell.
Roadmap note: office files sync via save-and-poll today. Character-level realtime co-editing (like Pages already have via Yjs/Hocuspocus) is the next step, as is a calendar app.
| Dashboard (Light) | Dashboard (Dark) |
|---|---|
 |
 |
| Collaborative Editing | Editing (Dark Mode) & Add Menu |
|---|---|
 |
  |
| Chat | Tasks |
|---|---|
 |
 |
| Admin Dashboard | Notifications |
|---|---|
 |
 |
OneFeather is built with a modern, high-performance tech stack designed for easy self-hosting and scaling:
- Framework: React 19 + Vite + TypeScript
- Styling: Tailwind CSS (with
clsx&tailwind-merge) - Animations: Framer Motion
- Editor: Blocknote & Tiptap (Rich text, block-based editing)
- Office Suite: dependency-free vanilla-JS apps in
web/public/apps/(OneDocs, OneSheets, OneSlides), bound to the workspace byweb/public/apps/of-bridge.js
- Framework: Fastify (Node.js) + TypeScript
- Database: SQLite (via
better-sqlite3) for simple, file-based persistence that requires zero setup. - ORM: Drizzle ORM
- Collaboration Engine: Hocuspocus & Yjs for real-time WebSocket syncing (CRDTs).
- Docker: Containerized frontend and backend for reproducible builds.
- Docker Compose: Single-command deployment (
docker-compose up -d) perfect for a single VPS. - Kubernetes / Helm: Helm charts included for scaling out in a Kubernetes cluster.
- Node.js (v18+)
- npm
cd server
npm install
npm run db:push # Initialize SQLite database
npm run db:seed # Demo users & content (alice/bob/admin @onefeather.local · "password")
npm run dev # Starts Fastify & WebSocket servercd web
npm install
npm run dev # Starts Vite dev serverDeploying to your own VPS is straightforward using Docker Compose:
# Clone the repository
git clone https://github.com/jonasgunklach/OneFeather.git
cd OneFeather
# Start the services
docker-compose up -dYour workspace will be up and running instantly. For advanced deployments, refer to the deploy/helm directory to deploy to Kubernetes.