mirror of
https://seed.radicle.dev/rad:z4V1sjrXqjvFdnCUbxPFqd5p4DtH5.git
synced 2026-11-03 18:50:30 +08:00
lorenz
af334bb0e4
1. When `git archive` errors, do not require an exit code, but just use
the `ExitStatus` we already have. This requires less unwrapping.
Also, the previous default of 0 was misleading, since 0 is returned
upon successful termination.
2. Use "refname" instead of "refspec" as these are different concepts.
Refer to <https://git-scm.com/docs/git-check-ref-format> and in
particular
<https://git-scm.com/docs/git-check-ref-format#Documentation/git-check-ref-format.txt---refspec-pattern>.
3. Only allow appending ".tar.gz" to commit IDs, not to refnames,
because refnames may contain the suffix ".tar.gz". It might look
weird, but it is not forbidden to do `git branch foo.tar.gz`.
4. `char::is_ascii` does not help sanitize refnames to file names. In
particular we have `'/'.is_ascii() == true`. Replace forward slashes
with two underscores.
Radicle Explorer
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:
Run the following commands to access the web UI locally:
git clone https://seed.radicle.xyz/z4V1sjrXqjvFdnCUbxPFqd5p4DtH5.git radicle-explorer
cd radicle-explorer
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:
- Run
npm install && npm buildto create a build for deployment - Configure your web server to serve the contents of the
/builddirectory
Using Vercel (or similar static file hosting):
- Fork this repository to create your own version
- Configure your Vercel account to deploy the forked repository
Configuration
There's two ways to configure the UI:
Create a local.json config file
- Copy default.json to a new file in the same folder called
local.json. - Modify the properties in
local.jsonto your preference.
Environment variables
- Check custom-environment-variables.json for all available environment variables.
- Set the desired environment variables when building the UI.
For advanced configuration options, have a look at the
node-configpackage.
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.