GitHub

Introduction

Getting Started

Easily bridge the gap between your React frontend and AdonisJS backend. Get a development experience similar to Remix while having the power of a full MVC framework at your fingertips.

Radonis is similar to Inertia.js, but does not offload all the rendering work to the client. It's like a traditional monolythic application architecture with modern, SPA-like DX.

Installation

Learn how to add Radonis to your AdonisJS application.

Compiler

Learn more about the built-in compiler.

Views

Learn more about views.

Components

Learn more about components.


Features

  • Renders React views directly from AdonisJS routes and controllers.
  • Partially hydrates only the components that require interactivity on the client (Islands Architecture).
  • Includes pre-made hooks for working with AdonisJS inside your React views, both on client and server.
  • Ships with a compiler powered by esbuild, no Webpack Encore required.

Quick start

Just want to get started? A few steps are required, even potentially some manual setup, but don't let that scare you.

Before you start

It's strongly recommended to set up Radonis in a fresh AdonisJS project created with the web project structure. If that's not what you plan to do, make sure to first push unstaged changes to your version control system.

Installing Radonis packages

Install the two Radonis core packages.

npm install --save @microeinhundert/radonis @microeinhundert/radonis-server

Configuring the server provider

Before Radonis can do its thing and hook into the AdonisJS lifecycle, you must register the Radonis service provider with your AdonisJS application.

node ace configure @microeinhundert/radonis-server

Configuring the required AdonisJS addons

Radonis requires the two official AdonisJS addons @adonisjs/i18n and @adonisjs/session to be installed and configured. Execute the following commands and follow the instructions output to the terminal.

node ace configure @adonisjs/i18n

and

node ace configure @adonisjs/session

Note

The two required addons were automatically installed in your projects package.json as part of the server provider configuration. Just the configuration command of the two addons is required to be run manually.


Plugins

UnoCSS

Add styling powered by UnoCSS to your Radonis application.

Twind

Add styling powered by Twind to your Radonis application.