愛がロックする。Rox.

Roxは、パフォーマンスと使いやすさに重点を置いたActivityPubサーバーです。Misskeyのクライアントやサービスと互換性を持てるよう設計されています。

日本発の技術スタックで構築 🇯🇵

Hono

Hono

Hono は、超高速で軽量なWeb標準APIベースのフレームワークです。エッジ環境での動作に最適化されており、ハイパフォーマンスなAPIやWebアプリを迅速に構築できます。

Learn Hono more →

Waku

Waku

Waku は、Reactの Server Components (RSC) を簡単に導入するためのフレームワークです。レンダリングとデータ取得をサーバー側で行うことで、初期ロード速度とサイトのパフォーマンスを劇的に向上させます。

Learn Waku more →

Jotai

Jotai

Jotai は、シンプルでアトムベースのReactステート管理ライブラリです。ボイラープレート(定型コード)を極限まで減らし、必要なコンポーネントだけに必要な状態を効率的に渡す、柔軟で軽量な仕組みを提供します。

Learn Jotai more →

主要機能

軽量・高性能

Bunランタイムとモダンなウェブ標準により、卓越した速度と効率を実現。

🌍

インフラ非依存

Dockerでもネイティブでも、軽量だから最小構成でも動かせる。

🔄

Misskey API互換

完全なAPI互換性により、既存のMisskeyユーザーがシームレスに移行可能。

💾

マルチデータベース対応

PostgreSQL、MySQL、SQLiteから、ニーズに応じて選択可能。

📦

柔軟なストレージ

ローカルファイルシステムまたはS3互換ストレージ(AWS S3、Cloudflare R2、MinIO)。

🎨

モダンUI

Waku、React Aria Components、Tailwind CSS v4で構築された美しくアクセシブルなインターフェース。

はじめに

数分でRoxを起動できます

1

リポジトリをクローン

git clone https://github.com/Love-rox/rox.git
cd rox
2

依存関係をインストール

bun install
3

環境変数を設定

cp .env.example .env
# .envファイルを編集して設定を行う
4

開発サービスを起動

docker compose up -d
5

データベースマイグレーションを実行

bun run db:generate
bun run db:migrate
6

開発サーバーを起動

bun run dev
# バックエンド: http://localhost:3000
# フロントエンド: http://localhost:3001

詳細なドキュメントについては、GitHubリポジトリをご覧ください。

開発ロードマップ

  • データベース抽象化(リポジトリパターン)
  • ストレージ抽象化(アダプターパターン)
  • 依存性注入のセットアップ
  • ユーザー認証・管理
  • ノート作成・タイムライン
  • リアクション・インタラクション
  • ファイルアップロード
  • Waku + Jotaiセットアップ
  • Tailwind CSS v4(OKLCHカラー)
  • React Aria Components
  • Lingui i18n(英語/日本語 - 87メッセージ)
  • 認証(パスキー + パスワード)
  • タイムライン(表示、無限スクロールページネーション)
  • ノートコンポーザー(テキスト、画像、CW、公開範囲、返信、リノート)
  • ユーザーインタラクション(返信、リアクション、フォロー/アンフォロー)
  • ファイルアップロード(複数画像、ドラッグ&ドロップ、プレビュー)
  • ユーザープロフィールページ(自己紹介、統計、投稿、フォローボタン)
  • 画像モーダル(ズーム、パン、ギャラリーナビゲーション)
  • アクセシビリティ(キーボードナビゲーション、フォーカス管理、ARIAラベル)
  • WebFinger(RFC 7033準拠)
  • Actorドキュメント(Person、JSON-LD)
  • HTTP署名(RSA-SHA256、hs2019)
  • Inbox(11種類のアクティビティ:Follow、Create、Like、Announce、Deleteなど)
  • Outbox & Collections(フォロワー/フォロー中)
  • アクティビティ配信キュー(BullMQ + Dragonfly)
  • 共有Inboxサポート(配信50-90%削減)
  • サーバーごとのレート制限
  • アクティビティ重複排除
  • 配信メトリクス&モニタリング
  • 連合テスト済み(Mastodon、Misskey、GoToSocial)
  • コードリファクタリング(inboxハンドラーを11個の専用ハンドラーに分割)
  • Redisキャッシング(CacheService経由でユーザープロフィール)
  • 画像最適化(ImageProcessor経由でWebP変換)
  • テストカバレッジ改善(180以上のユニットテスト)
  • 管理者ロールと権限(requireAdminミドルウェア)
  • インスタンスブロック管理(API + 連合強制)
  • ユーザー停止/モデレーション(API + 認証強制)
  • レート制限(ミドルウェア実装済み)
  • 入力検証(Zodスキーマ)
  • ヘルスチェックとメトリクスエンドポイント
  • デプロイメントドキュメント(Docker&ベアメタル)
  • CI/CDワークフロー(GitHub Actions)
  • 180以上のユニットテスト
  • EventBusアーキテクチャ(before/afterライフサイクルフック)
  • セキュアプラグインコンテキスト(パーミッションベースサンドボックス)
  • プラグインレジストリ(動的ロード・ライフサイクル管理)
  • UIスロットシステム(コンポーネント注入ポイント)
  • ホットリロードサポート(開発モード)
  • サンプルプラグイン(activity-logger、auto-cw)
  • プラグイン開発ドキュメント(日本語/英語)
  • プラグインマーケットプレイス
  • 公式プラグイン開発
  • サードパーティ連携強化