diff --git a/docs/overview/introduction.mdx b/docs/overview/introduction.mdx index d2be514f3..734c4da3e 100644 --- a/docs/overview/introduction.mdx +++ b/docs/overview/introduction.mdx @@ -1,133 +1,124 @@ --- title: Welcome to Spacedrive -description: The future of files is here +description: Infrastructure for multi-device computing sidebarTitle: Introduction --- -Your files are scattered across devices, trapped in cloud silos, and held hostage by subscription fees. Spacedrive unifies everything into one seamless experience, giving you back control of your digital life. + +**Code Open-Sourced: December 1, 2025** + +This codebase is being released early for community testing and feedback. The first public release (2.0.0-pre.1) is coming before Christmas 2025. + +spacedrive.com still shows v0.4.3. The new site launches with the release. Until then, these docs are your primary resource. + ## What is Spacedrive? -Spacedrive is an open-source file manager that creates a distributed filesystem across all your devices. Access files from anywhere, organize everything in one place, and keep your data private. +Spacedrive is a local-first file manager that unifies data across devices without centralized cloud services. Files stay where they are. Spacedrive creates a content-aware index that makes them searchable, syncable, and manageable from anywhere. - - **Version 2.0** - Rewritten from the ground up, feature complete and fully - extensible. - +## Why Spacedrive Exists -## The Problem We Solve +Computing was designed for single devices. File managers like Finder and Explorer assume your data lives on the computer in front of you. The shift to multi-device forced us into cloud ecosystems. Convenience required giving up data ownership. - - - Files spread across phones, laptops, drives, and cloud services - - - Monthly fees and vendor control over your own data - - - Your files processed and analyzed by third parties - - +AI is accelerating this trend. Cloud services offer semantic search and intelligent analysis, but only if you upload your files to their infrastructure. Spacedrive is building the architecture for local AI on hardware you already own, on data that never leaves your control. -## Your Data, Your Control +This is infrastructure for the next era of computing. -Spacedrive connects your devices directly, no middleman required: +## Current State -**Free Forever** - Open source with no subscription fees or limits. +### What Works Now (December 2025) -**True Privacy** - Files transfer directly between your devices using encrypted P2P connections. +**MacOS (Primary Testing Platform)** +- Tauri desktop app with working interface +- File indexing and analysis (OCR, transcriptions, thumbnails) +- Multi-device library sync +- Content identity and deduplication +- CLI for daemon management -**Works Everywhere** - Mac, Windows, Linux, iOS, and Android. Your files follow you. +**Windows & Linux (Community Testing)** +- Everything should work theoretically +- Not fully tested yet, bugs expected +- Help us validate cross-platform support -**No Internet Required** - Sync and access files on your local network, completely offline. +**CLI** +- Full library management +- Daemon control +- Best way to test core functionality -## Key Features +### Coming in 2.0.0-pre.1 (Before Christmas) -### For Everyone +- Mobile app (React Native) +- Spacedrive Cloud deployment +- Extension SDK (stable) +- AI integration (local models) +- File sync (currently library sync only) +- New spacedrive.com - - - Back up photos from your iPhone to any device you own. Available today. - - - Find any file instantly across all your devices from one search box - - - Tag and organize files once, see them everywhere - - - Browse photos and videos with beautiful gallery views - - +### Prototypes (Not Public) -### For Power Users +Native Swift apps (iOS, macOS) and a GPUI media viewer exist as private prototypes. These demonstrate type-safe native integration and platform-specific optimizations. They may become production apps if performance demands it. - - - Full command-line control with daemon architecture - - - Automatically detect and manage duplicate files - - - Access remote files as if they were local - - - Build custom workflows with our SDK - - +## How It Works -## Getting Started +Spacedrive treats files as first-class objects with content identity. A photo on your laptop and the same photo on your NAS are recognized as one piece of content. - - - Get Spacedrive for your platform from our [downloads page](/downloads) - - - Set up your first library to start organizing files - - Connect your other devices to sync and share - +**Core capabilities:** +- Search millions of files in under 100ms +- Preview operations before execution (conflicts, space savings, outcomes) +- Sync peer-to-peer without servers or consensus protocols +- Track redundancy across devices +- Full offline functionality + +Files stay in place. Spacedrive makes them universally addressable with rich metadata. + +## Testing & Feedback + +This testing period is important. We need community help validating: +- Cross-platform compatibility (especially Windows/Linux) +- v1 to v2 library migration +- Multi-device sync scenarios +- Performance at scale + +Current v0.4.3 users will migrate when 2.0.0-pre.1 releases. Your testing helps ensure that transition is smooth. - Start with iOS photo backup - it's the easiest way to experience Spacedrive's - power. Just install on your iPhone and Mac, then follow the setup wizard. +MacOS users: Focus on testing indexing, multi-device sync, and the interface. Windows/Linux users: Report any bugs you encounter. All feedback is valuable. -## For Users - - - - Get up and running in 5 minutes - - - Explore what Spacedrive can do - - - ## For Developers - - - Deep dive into Spacedrive internals - - - Help build the future of file management - - - -## Learn More - - - - Why we're building Spacedrive - - - Technical vision and roadmap - - - - Spacedrive is under active development. Join our - [Discord](https://discord.gg/spacedrive) to follow progress and get help. +**Most architecture docs are in the Developer section.** The core technical documentation lives under [Architecture](/core/architecture), not in overview guides. + +Key technical docs: +- [Architecture Overview](/core/architecture) - System design and principles +- [Data Model](/core/data-model) - How data is structured +- [Content Addressing](/core/addressing) - Content identity system +- [Library Sync](/core/library-sync) - Multi-device synchronization +- [Testing Guide](/core/testing) - Test framework and patterns + +## Roadmap + +The `.tasks` folder in the repo tracks core development work. The new landing page (releasing with 2.0.0-pre.1) will have a public roadmap. For now, `.tasks` and these docs are the best reference. + + +Some guides are written as if features are complete. This is intentional—they document the release state, not current state. When features aren't ready yet, you'll see callouts like this. + + +## Project Timeline + +Spacedrive v2 development began in June 2025. This is a ground-up rewrite addressing lessons from the v1 alpha. The architecture is designed for long-term sustainability, not quick feature delivery. + +Six months later, the core is stable enough for community testing. The Christmas release will be feature-complete for the advertised capabilities. + +## Get Involved + +- **Test the code** - Build from source, report bugs, validate cross-platform +- **Join Discord** - [discord.gg/gTaF2Z44f5](https://discord.gg/gTaF2Z44f5) +- **Read the whitepaper** - [whitepaper/spacedrive.pdf](https://github.com/spacedriveapp/spacedrive/blob/main/whitepaper/spacedrive.pdf) (work in progress) +- **Explore architecture docs** - Start with [core/architecture](/core/architecture) + + +This is a living document. As development progresses toward the Christmas release, this page will be updated to reflect current status. +