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
Run on traditional VPS with Docker or edge environments like Cloudflare Workers/D1.
Misskey API Compatible
Seamless migration for existing Misskey users with full API compatibility.
Multi-Database Support
Choose from PostgreSQL, MySQL, or SQLite/D1 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
- ▸Plugin architecture design
- ▸Extension points
- ▸Plugin marketplace
Join the Community
Contribute to Rox and help build the future of ActivityPub