# rshono

> rshono is a minimalist web framework built on Hono, Rspack and React Server Components. One required file (src/routes.ts), one optional file (src/server.ts), and you get a dev server with HMR, streaming SSR with RSC hydration, server actions with progressive enhancement, soft navigation, build-time prerendering, and hard env/secret safety.

Every documentation page is available as Markdown by appending `.md` to its URL.
The whole corpus in one file: https://www.rshono.com/llms-full.txt

## Introduction

- [Getting started](https://www.rshono.com/docs/getting-started.md): Scaffold an app, run the dev server, ship a production build.
- [Project layout](https://www.rshono.com/docs/project-layout.md): The two files the framework knows about — everything else is yours to arrange.

## Core concepts

- [Routing](https://www.rshono.com/docs/routing.md): src/routes.ts — the one file rshono requires, and the only place routes are declared.
- [Pages](https://www.rshono.com/docs/pages.md): A page is a React server component that renders the whole document and receives the request.
- [Server actions](https://www.rshono.com/docs/server-actions.md): 'use server' functions, callable from the client, with progressive enhancement.
- [Hono & middleware](https://www.rshono.com/docs/hono.md): src/server.ts is a Hono sub-app — middleware, endpoints, end-to-end types, error reporting.

## Advanced

- [Styling & assets](https://www.rshono.com/docs/styling.md): Native CSS code-split per route, the four lines that add Tailwind, and public/.
- [Configuration & security](https://www.rshono.com/docs/configuration.md): rshono.config.ts — every field, the secret boundary, and what is hardened by default.
- [Deployment](https://www.rshono.com/docs/deployment.md): Four targets behind one interface, how the build produces them, and the known limitations.

## Reference

- [API reference](https://www.rshono.com/docs/api.md): Every export of @rshono/core, @rshono/core/server and @rshono/core/client, in one place.