Build your corner
of the internet.
A social network to build on. React hooks to make it yours.
Bring your interface. The communities are already here.
npm install @bitsocial/bitsocial-react-hooksimport { useFeed } from "@bitsocial/bitsocial-react-hooks"; function YourFeed({ communityName }) { const { feed, hasMore, loadMore } = useFeed({ communities: [{ name: communityName }], sortType: "hot", postsPerPage: 3, }); return ( <div className="preview-feed"> <header className="preview-feed-header"> <img className="preview-community-icon" src="/playground/builders-icon.webp" alt="" /> <div><strong>Community feed</strong><small>{communityName}</small></div> </header> {feed.map(post => ( <article className="preview-post" key={post.cid}> <div className="preview-byline"> <span className="preview-avatar" data-author={post.author.address} aria-hidden="true"> {post.author.displayName?.slice(0, 1)} </span> <div><strong>{post.author.displayName}</strong><small>{post.author.shortAddress}</small></div> </div> <h2>{post.title}</h2> <p>{post.content}</p> {post.thumbnailUrl && <img className="preview-post-image" src={post.thumbnailUrl} alt="A handmade radio on a shared workshop table" />} <footer className="preview-post-meta"> <span>↑ {(post.upvoteCount ?? 0) - (post.downvoteCount ?? 0)} points</span> <span>{post.replyCount} replies</span> </footer> </article> ))} {hasMore && ( <button onClick={() => void loadMore()}> Load more </button> )} </div> ); }
You bring the idea.
The hooks do the plumbing.
Feeds, conversations, accounts, and publishing.
Compose what you need into something new.
A feed with your point of view
Combine communities, choose a sort, and load the next page. You decide what discovery looks like.
useFeed ↗Conversations that connect
Turn a post into a thread. Read comments and replies, with updates flowing into your UI.
useComment · useReplies ↗Accounts people own
Local accounts, portable keys, and subscriptions. Build an experience around people, not logins.
useAccount ↗Let people take part
Publish, reply, and vote. Handle community challenges with explicit state and callbacks.
usePublishComment ↗The next social app
could be yours.
Build a forum for a niche you care about. Try a different kind of feed. Give an existing community a better home.
Bitsocial is an open peer-to-peer network. Compatible apps can share communities and content, while competing on what makes them useful.
Read the call to buildersBring your AI collaborator.
The same docs, ready for your coding agent. Plain Markdown, a compact index, and the full reference.