57 releases (14 breaking)

new 0.14.1 Nov 24, 2024
0.13.3 Nov 20, 2024
0.8.3 Jul 27, 2024

#2141 in Web programming

Download history 2/week @ 2024-08-04 489/week @ 2024-08-11 331/week @ 2024-08-18 5/week @ 2024-08-25 133/week @ 2024-09-15 3/week @ 2024-09-22 273/week @ 2024-09-29 25/week @ 2024-10-06 490/week @ 2024-10-13 29/week @ 2024-10-20 9/week @ 2024-10-27 386/week @ 2024-11-03 416/week @ 2024-11-10 878/week @ 2024-11-17

1,689 downloads per month

Custom license

49KB
1K SLoC

Documentation | Tutorial | Discord | ✨Contributing

Tuono

Tuono is a full-stack web framework for building React applications using Rust as the backend with a strong focus on usability and performance.

Tuono (Italian word for "thunder", pronounced /2 Oh No/). Why Tuono? Just a badass name.

If you have experience with Next.js you will feel home here.

Some of its features are:

  • 🟦 Native Typescript
  • 🌐 Next.js like Routing
  • 🍭 CSS/SCSS modules
  • 🧬 Server Side Rendering
  • 🔥 Hot Module Reload

📖 Documentation

The documentation is available on tuono.dev.

Introduction

NodeJs/Deno/Bun are the only runtimes that allow a React app to be full-stack right? (no)

Tuono is a full-stack React framework with the server side written in Rust. Because of this, Tuono is extremely fast, and the requests are handled by a multithreaded Rust server. React is still React - it is just superpowered.

Rust is a hard language, then writing server-side code is hard as well, right? (no again)

Tuono provides a collection of utilities to handle the server side code seamlessly with the React code. Each server-side route is managed in a separate file alongside the React route. The routing is handled by Tuono based on the files defined within the ./src/routes directory.

How is Tuono different from Next.js?

The Tuono API tries to stick as much as possible to the Next.js one (or at least takes a huge inspiration from it). The major difference is the backend system. While Next.js relies entirely on Node/Deno/Bun, Tuono runs the server without any intermediary runtime. This enables impressive performance improvements (check the benchmarks here).

Getting started

Tuono is the CLI that provides all the needed commands to handle the full-stack project. To download it is required cargo, which is the rust package manager.

Then run cargo install tuono.

To list all the available commands, run tuono -h

To create a new project, run tuono new [NAME] (optionally, you can pass the --template (or -t) flag - check the examples folder).

Then, to run the local development environment, install the JS dependencies (npm install) and run inside the project folder tuono dev

Finally, when the project is ready to be deployed, just run tuono build to create the final React assets and to set the server project in production mode.

Now to execute it just run cargo run --release.

Contributing

Any help or suggestion will be appreciated and encouraged. Check the ✨Contributing page

License

This project is licensed under the MIT License.

Dependencies

~92MB
~2M SLoC