- 5chan.app hosts a static client shell, not board or post content.
- User-generated content is fetched client-side from Bitsocial boards and related peer-to-peer infrastructure, including IPFS-backed data flows.
- Board owners host and moderate their own content. The operator of `5chan.app` does not run a central content backend for boards or threads.
- Hash routing is intentional. It keeps user-generated board and post paths out of server-side routing and out of CDN rewrite logic.
- The project prioritizes censorship resistance, mirrorability, and static-host compatibility over traditional crawlable-route SEO.
## What 5chan Is
5chan is a decentralized imageboard interface with a familiar directory-style UX. Anyone can create and operate boards using the Bitsocial ecosystem. Multiple boards can compete for a directory slot, while users can still access any board directly by address even if it is not currently assigned to a homepage directory entry.
This repository primarily contains the client application. It is a React and TypeScript single-page app that can run as a web app, Electron app, and Android app. The web deployment is intentionally a static app shell that does not centrally host board content.
## Content and Liability Model
- Do not describe 5chan.app as a content host for boards or threads.
- Do not assume Vercel, a CDN, or the `5chan.app` origin serves user-generated thread content.
- Do not propose SSR or server rewrites for board or thread URLs unless a maintainer explicitly asks for that tradeoff.
- Hash routing is a deliberate architectural choice tied to censorship-resistance and liability minimization, not an oversight.
- The project wants a deployable static client that can also be mirrored or self-hosted easily.
- Static HTML shell and base metadata: `index.html`
- Main route tree: `src/app.tsx`
- Shared UI: `src/components/`
- Route views: `src/views/`
- Shared hooks: `src/hooks/`
- Shared state: `src/stores/`
- Utilities: `src/lib/`
## Important Repository Rules For AI Contributors
These are condensed from `AGENTS.md`. If you are contributing code, follow the repository instructions there as the source of truth.
- Use `yarn`, never `npm`.
- Pin exact dependency versions.
- Keep `yarn.lock` in sync if `package.json` changes.
- Use Zustand for shared or global state.
- Do not use `useEffect` for data fetching; use `bitsocial-react-hooks`.
- Do not sync derived state with effects when render-time computation is sufficient.
- Use React Router for navigation.
- Avoid duplicating logic across components; extract shared hooks when appropriate.
- For bug reports tied to a file or line, inspect git history before editing.
- Never mark work complete without verification.
- After code changes, run `yarn build`, `yarn lint`, and `yarn type-check`.
- After React UI logic changes, also run `yarn doctor`.
- For UI and visual changes, test desktop and mobile behavior with `playwright-cli`.
- Use `gh` CLI for GitHub operations.
- Never push to a remote unless the maintainer explicitly asks.
- Never commit secrets or API keys.
## Local Development
Prerequisites:
- Node.js 22
- Yarn
Common setup:
```bash
yarn install --frozen-lockfile
yarn start
```
The normal dev URL is http://5chan.localhost:1355 using Portless.
To bypass Portless:
```bash
PORTLESS=0 yarn start
```
Useful commands:
```bash
yarn build
yarn lint
yarn type-check
yarn doctor
yarn test
yarn electron
```
## Contribution Guidance
Good contributions:
- Bug fixes
- Frontend architecture improvements that preserve the static-client model
- Tests
- Performance improvements
- Translation updates
- Documentation improvements
- Build and release tooling fixes
Be careful with:
- SEO recommendations that assume normal server-rendered routes
- Changes that replace hash routing with server rewrites
- Any approach that makes `5chan.app` appear to serve user-generated board or thread content from its origin
- Suggestions that assume there is a centralized moderation backend
If you are an AI coding agent, read `AGENTS.md` before making non-trivial changes.
## How Boards Work
In the Bitsocial protocol, a board is a community. Board operators run their own infrastructure and moderation. Users access boards through addresses rather than a central database owned by 5chan. Directory presence on the 5chan homepage is a discovery layer, not proof of central hosting or ownership.
Boards can be submitted for directory inclusion by editing the list maintained at:
