# 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: http://www.rshono.com/llms-full.txt

## Introduction

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

## Core concepts

- [Routing](http://www.rshono.com/docs/routing.md): src/routes.ts — the one file rshono requires, and the only place routes are declared.
- [Pages](http://www.rshono.com/docs/pages.md): A page is a React server component that renders the whole document and receives the request — and the 'use server' actions it mutates through.
- [Hono & middleware](http://www.rshono.com/docs/hono.md): src/server.ts is a Hono sub-app — middleware, endpoints, end-to-end types, error reporting.
- [Usage](http://www.rshono.com/docs/usage.md): Putting it together — co-located actions, streamed data and optimistic updates, in the shapes most of an app is built from.

## Advanced

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

## Reference

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

## Optional

- [Hono llms.txt](https://hono.dev/llms.txt): The server rshono runs on — `src/server.ts` is a Hono app, and an endpoint handler is a Hono handler.
- [Rspack llms.txt](https://rspack.rs/llms.txt): The bundler behind `rshono dev` and `rshono build`. rshono writes the config; the `rspack` hook extends it.
- [React llms.txt](https://react.dev/llms.txt): Server and client components, hooks, and the rest of the model pages are written in.