Environment Setup

To get started contributing to Spacedrive, follow this guide carefully.

This project uses Cargo and pnpm.

Installation

1. Clone repo

   git clone https://github.com/spacedriveapp/spacedrive && cd spacedrive
   

2. Run setup script

   For Linux or MacOS users run:

   ./.github/scripts/setup-system.sh
   

   This will install FFmpeg and any other required dependencies for Spacedrive to build.

   ...or for Windows users run using PowerShell:

   .\.github\scripts\setup-system.ps1
   

   This will install pnpm, LLVM, FFmpeg and any other required dependencies for Spacedrive to build. Ensure you run it like documented above as it expects it is executed from the root of the repository.

3. Install dependencies

   pnpm i
   

4. Run codegen & build required dependencies

   pnpm prep
   

Running apps

• Desktop: pnpm desktop dev
• Landing: pnpm landing dev
• Server: DATA_DIR=/path/to/library cargo run -p sdcore
• Webapp: pnpm web dev

Mobile app

To run mobile app

1. Install Android Studio for Android and Xcode for IOS development
2. ./.github/scripts/setup-system.sh mobile The should setup most of the dependencies for the mobile app to build.
3. You must also ensure you have NDK 24.0.8215888 and CMake in Android Studio
4. cd apps/mobile && pnpm i - This is a separate workspace, you need to do this!
5. pnpm android - runs on Android Emulator
6. pnpm ios - runs on iOS Emulator
7. pnpm dev - For already bundled app - This is only temporarily supported. The final app will require the Spacedrive Rust code which isn't included in Expo Go.

Troubleshooting

If you are having issues ensure you are using the following versions of Rust and Node:

• Rust version: 1.67.0
• Node version: 17