The Love Rocks. Rox.
Rox is a ActivityPub server focused on performance and usability. Compatible with Misskey clients and services.
Made with Japanese stack 🇯🇵
Hono
Hono is an ultra-fast, lightweight framework based on web standards APIs. Optimized for edge environments, it enables rapid development of high-performance APIs and web applications.
Learn Hono more →Waku
Waku is a framework that simplifies the adoption of React Server Components (RSC). By performing rendering and data fetching on the server side, it dramatically improves initial load speed and overall site performance.
Learn Waku more →Jotai
Jotai is a simple and atomic React state management library. It minimizes boilerplate code and provides a flexible, lightweight mechanism to efficiently pass only the necessary state to the components that need it.
Learn Jotai more →Additional Technologies
Key Features
Lightweight & High Performance
Built with Bun runtime and modern web standards for exceptional speed and efficiency.
Infrastructure Agnostic
Whether Docker or native, it's lightweight so it runs on minimal configurations.
Misskey API Compatible
Seamless migration for existing Misskey users with full API compatibility.
Multi-Database Support
Choose from PostgreSQL, MySQL, or SQLite based on your needs.
Flexible Storage
Local filesystem or S3-compatible storage (AWS S3, Cloudflare R2, MinIO).
Modern UI
Built with Waku, React Aria Components, and Tailwind CSS v4 for a beautiful, accessible interface.
Getting Started
Get up and running with Rox in minutes
Clone the repository
git clone https://github.com/Love-rox/rox.git
cd roxInstall dependencies
bun installSetup environment variables
cp .env.example .env
# Edit .env with your configurationStart development services
docker compose up -dRun database migrations
bun run db:generate
bun run db:migrateStart development servers
bun run dev
# Backend: http://localhost:3000
# Frontend: http://localhost:3001For detailed documentation, visit our GitHub repository.
Development Roadmap
- ▸Database abstraction (Repository Pattern)
- ▸Storage abstraction (Adapter Pattern)
- ▸Dependency Injection setup
- ▸User authentication & management
- ▸Note creation & timeline
- ▸Reactions & interactions
- ▸File uploads
- ▸Waku + Jotai setup
- ▸Tailwind CSS v4 with OKLCH colors
- ▸React Aria Components
- ▸Lingui i18n (English/Japanese - 87 messages)
- ▸Authentication (Passkey + Password)
- ▸Timeline (display, infinite scroll pagination)
- ▸Note Composer (text, images, CW, visibility, reply, renote)
- ▸User interactions (reply, reaction, follow/unfollow)
- ▸File uploads (multiple images, drag & drop, preview)
- ▸User profile pages (bio, stats, posts, follow button)
- ▸Image modal (zoom, pan, gallery navigation)
- ▸Accessibility (keyboard navigation, focus management, ARIA labels)
- ▸WebFinger (RFC 7033 compliant)
- ▸Actor documents (Person, JSON-LD)
- ▸HTTP Signatures (RSA-SHA256, hs2019)
- ▸Inbox (11 activity types: Follow, Create, Like, Announce, Delete, etc.)
- ▸Outbox & Collections (followers/following)
- ▸Activity delivery queue (BullMQ + Dragonfly)
- ▸Shared inbox support (50-90% delivery reduction)
- ▸Per-server rate limiting
- ▸Activity deduplication
- ▸Delivery metrics & monitoring
- ▸Federation tested with Mastodon, Misskey, GoToSocial
- ▸Code refactoring (inbox handlers split into 11 dedicated handlers)
- ▸Redis caching (user profiles via CacheService)
- ▸Image optimization (WebP conversion via ImageProcessor)
- ▸Test coverage improvement (180+ unit tests)
- ▸Admin role and permissions (requireAdmin middleware)
- ▸Instance block management (API + federation enforcement)
- ▸User suspension/moderation (API + auth enforcement)
- ▸Rate limiting (middleware implemented)
- ▸Input validation (Zod schemas)
- ▸Health checks and metrics endpoints
- ▸Deployment documentation (Docker & Bare Metal)
- ▸CI/CD workflow (GitHub Actions)
- ▸180+ unit tests
- ▸EventBus architecture (before/after lifecycle hooks)
- ▸Secure plugin context (permission-based sandbox)
- ▸Plugin registry (dynamic loading & lifecycle management)
- ▸UI slot system (component injection points)
- ▸Hot reload support (development mode)
- ▸Sample plugins (activity-logger, auto-cw)
- ▸Plugin development documentation (English/Japanese)
- ▸Plugin marketplace
- ▸Official plugin development
- ▸Enhanced third-party integrations
Join the Community
Contribute to Rox and help build the future of ActivityPub