Skip to content

bitsocialhq/seedit

Repository files navigation

Build Status Release License Commitizen friendly

Telegram group for this repo https://t.me/seeditreact

Seedit

Seedit is a serverless, adminless, decentralized and open-source (old)reddit alternative built on the Bitsocial protocol. Like reddit, anyone can create a seedit community, It features a similar homepage structure as reddit, but with a crucial difference: anyone can create and own communities, and multiple communities can compete for each default community slot.

Downloads


How to create a community

To run a community, you can choose between two options:

  1. If you prefer to use a GUI, download the desktop version of the Seedit client, available for Windows, MacOS and Linux: latest release. Create a community using using the familiar old.reddit-like UI, and modify its settings to your liking. The app runs an IPFS node, meaning you have to keep it running to have your board online.
  2. If you prefer to use a command line interface, install bitsocial-cli, available for Windows, MacOS and Linux: latest release. Follow the instructions in the readme of the repo. When running the daemon for the first time, it will output WebUI links you can use to manage your community with the ease of the GUI.

Peers can connect to your bitsocial community using any bitsocial client, such as Seedit or 5chan. They only need the community address, which is not stored in any central database, as bitsocial is a pure peer-to-peer protocol.

How to add a community to the default list (s/all)

The default list of communities, used on s/all on Seedit, is bitsocial's default-multisub.json list. You can open a pull request in that repo to add your community to the list.

To run locally

  1. Install Node v22 (Download from https://nodejs.org)
  2. Install Yarn: npm install -g yarn
  3. yarn install --frozen-lockfile to install Seedit dependencies
  4. yarn start to run the web client

Scripts:

  • Web client: yarn start
  • Electron client (must start web client first): yarn electron
  • Electron client and don't delete data: yarn electron:no-delete-data
  • Web client and electron client: yarn electron:start
  • Web client and electron client and don't delete data: yarn electron:start:no-delete-data

Build:

The linux/windows/mac/android build scripts are in https://github.com/bitsocialhq/seedit/blob/master/.github/workflows/release.yml