rshono
A minimal web framework combining Hono, Rspack, and React Server Components for high-performance, explicit routing and efficient server-side rendering.
rshono is a high-performance, minimal web framework that integrates Hono for routing, Rspack for high-speed builds, and React Server Components for efficient rendering. It is designed for developers who prefer explicit configuration over directory-based conventions, requiring only a single mandatory route file and providing a streamlined toolchain that works across Node.js, Cloudflare Workers, Vercel, and AWS Lambda. The framework prioritizes performance and ergonomics, allowing developers to write server and client code together while maintaining a small dependency footprint and fast build times.
Functionality is centered around a clear, explicit route table where every page and endpoint is declared in a single file, eliminating the complexity of filesystem routing. By using React Server Components, rshono enables server-side data fetching directly within components, while its Hono-based foundation ensures that middleware, cookies, and headers are managed through a standard, familiar interface. The framework handles build orchestration and asset bundling, providing per-route code splitting and automatic handling of the RSC life cycle without requiring complex asset manifests or manual directive placement in most cases.
Some of the key features are:
- Explicit Routing: Every page and API endpoint is declared in a single source file, allowing for easy refactoring and navigation.
- Hono Foundation: Leverages Hono for the underlying server application, providing access to extensive middleware support and high throughput.
- Rspack Build System: Utilizes Rspack for optimized, fast production builds with native React Server Component support.
- Direct Data Access: Enables server components to fetch data directly from databases without requiring an intermediate API layer.
- Unified Toolchain: Offers a consistent development and production build experience across diverse deployment environments like Node, Cloudflare, Vercel, and AWS Lambda.
- Progressive Enhancement: Supports server actions that function before client hydration and even with JavaScript disabled.
- Built-in Security: Simplifies security practices by integrating directly with standard Hono middleware for CSRF protection, request body limits, and CSP management.
- High Performance: Designed for speed, delivering smaller payloads and faster production build times compared to many standard industry frameworks.
Operation is straightforward: projects are scaffolded via a CLI that configures the preferred deployment target, styling, and linting options. The framework uses a dedicated dev server with Hot Module Replacement (HMR) for instant feedback during development, while production builds produce a self-contained bundle ready for deployment. Configuration is handled optionally through a single root-level file, and the framework’s use of standard Hono patterns ensures that developers can leverage existing ecosystem knowledge for handling requests, headers, and authentication.
Some common use cases include:
- Full-stack Web Applications: Building robust applications that require efficient server-side rendering and interactive client-side features.
- API-heavy Services: Leveraging Hono’s performance to build high-concurrency JSON APIs alongside traditional page routes.
- Serverless Deployments: Deploying performance-critical web applications to edge compute platforms or serverless functions with minimal cold-start overhead.
- Performance-first Projects: Projects requiring strict control over bundle sizes, payload delivery, and initial render speeds.