[Documentation](https://tuono.dev) | [Tutorial](https://tuono.dev/documentation/tutorial) |
[Discord](https://discord.com/invite/khQzPa654B) | [✨Contributing](https://tuono.dev/documentation/contributing)

# Tuono

<img align="right" src="https://raw.githubusercontent.com/tuono-labs/tuono/main/assets/logo.png" width="160px">

![](https://github.com/tuono-labs/tuono/actions/workflows/rust.yml/badge.svg)
![](https://github.com/tuono-labs/tuono/actions/workflows/typescript.yml/badge.svg)

**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](https://nextjs.org/) 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](https://tuono.dev/) is available on
[tuono.dev](https://tuono.dev/).

## Installation

Available on MacOS, Linux and Windows.

```sh
cargo install tuono
```

## Getting started

Create a new project with:

```sh
tuono new [PROJECT_NAME]
```

> You can optionally pass the --template (or -t) flag to directly start from a [template](https://github.com/tuono-labs/tuono/tree/main/examples)

Now just install the dependencies with you favourite JS package manager (i.e. `npm install`) and start the development environment

```sh
tuono dev
```

## Contributing

Any help or suggestion will be appreciated and encouraged.
Check the [✨Contributing](https://tuono.dev/documentation/contributing) page

## License

This project is licensed under the MIT License.