Skip to content
/ perseus Public
forked from framesurge/perseus

A high-level web development framework for Rust with full support for server-side rendering and static generation.

License

Notifications You must be signed in to change notification settings

zmilan/perseus

 
 

Repository files navigation

Perseus

Book API Docs Crate Page Top Language Discord Chat

Perseus is a blazingly fast frontend web development framework built in Rust with support for major rendering strategies, reactivity without a virtual DOM, and extreme customizability. It wraps the lower-level capabilities of Sycamore!

  • 📕 Supports static generation (serving only static resources)
  • 🗼 Supports server-side rendering (serving dynamic resources)
  • 🔧 Supports revalidation after time and/or with custom logic (updating rendered pages)
  • 🛠️ Supports incremental regeneration (build on demand)
  • 🏭 Open build matrix (use any rendering strategy with anything else)
  • 🖥️ CLI harness that lets you build apps with ease and confidence
  • 🌐 Full i18n support out-of-the-box with Fluent

Usage

Here's a taste of Perseus (see the tiny example for more):

use perseus::{define_app, ErrorPages, Template};
use sycamore::template;
define_app! {
    templates: [
        Template::<G>::new("index").template(|_| {
            template! {
                p { "Hello World!" }
            }
        })
    ],
    error_pages: ErrorPages::new(|url, status, err, _| {
        template! {
            p { (format!("An error with HTTP code {} occurred at '{}': '{}'.", status, url, err)) }
        }
    })
}

Check out the book to learn how to turn that into your next app!

Aim

Support every major rendering strategy and provide developers the ability to efficiently create super-fast apps with Rust and a fantastic developer experience!

Motivation

There is a sore lack of Rust frameworks for frontend development that support more than just SPAs and client-side rendering, and so Perseus was born. We need something like NextJS for Wasm.

Roadmap

Pre-stable

These tasks still need to be done before Perseus can be pushed to v1.0.0.

  • Create a custom CLI as a harness for apps without ridiculous amounts of configuration needed
  • Support i18n out of the box
  • Implement custom router
  • Allow direct modification of the document head
  • Improve SEO and initial load performance
  • Support custom template hierarchies
  • Pre-built integrations
    • Actix Web
    • Warp
    • AWS Lambda

Beyond

These tasks will be done after Perseus is stable.

  • Integrations for other platforms

Contributing

We appreciate all kinds of contributions, check out our contributing guidelines for more information! Also, please be sure to follow our code of conduct.

You can also chat about Perseus on our channel on Sycamore's Discord server.

License

See LICENSE.

About

A high-level web development framework for Rust with full support for server-side rendering and static generation.

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 96.5%
  • Fluent 1.6%
  • CSS 1.4%
  • Other 0.5%