Radicle Web UI

This user interface lets you interact with Radicle, a peer-to-peer code collaboration and publishing stack, directly from your web browser.

Deployment Options:

• Public Server: The Radicle team maintains a public instance at app.radicle.xyz
• Local-first: Run the UI locally
• Self-hosting: Deploy the UI on your own server

Local-first

Prerequisites:

• Recent versions of Node.js (20.9.0 or higher) and npm installed

Run the following commands to access the web UI locally:

git clone https://seed.radicle.garden/z4V1sjrXqjvFdnCUbxPFqd5p4DtH5.git radicle-interface
cd radicle-interface
npm install
npm start

Then open http://localhost:3000 in your favourite browser.

Self-Hosting the UI

There are several ways to deploy the UI publicly. Here are two common options:

Using your own web server:

1. Run npm install && npm build to create a build for deployment
2. Configure your web server to serve the contents of the /build directory

Using Vercel (or similar static file hosting):

1. Fork this repository to create your own version
2. Configure your Vercel account to deploy the forked repository

Contributing

• For detailed contribution guidelines, refer to the CONTRIBUTING.md file
• To propose changes, open an issue or submit a patch using Radicle

Getting in touch

To get in touch with the maintainers, sign up to our official chat on Zulip.

License

The UI is distributed under the terms of GPLv3. See LICENSE for details.