Skip to content

Starting project template for Rust Axum backend and Svelte frontend

License

Notifications You must be signed in to change notification settings

maxcountryman/svelte-axum-project

 
 

Repository files navigation

svelte-axum-project

Starting project template for Rust Axum backend and Svelte frontend. Simple Single-Page-App (SPA) example. Does not use SvelteKit.

New Version 0.4.1

  • bumped version on backend; axum to 0.6.20, axum-sessions to 0.5, tower-http to 0.4
  • bumped versions on front-end; vite-plugin-svelte to 2.4.2, svelte to 4.0.5, vite to 4.4.5
  • backend changed how servedir works from tower-http for serving front end static assets

New Version 0.4.0

  • updated to axum 0.6
  • changes to State usage; how its setup with route and called from middleware
  • changes to ordering of parameters in functions; last parameter can consume request body
  • eliminated axum::extract::RequestParts with help from update on axum-sessions
  • updated to axum-sessions 0.4 to match
  • incremented tokio version to 1.24
  • old axum 0.5 version is kept under branch v0.3_Axum0.5

Help

  • If anyone has ideas of how to implement a build file that would handle the npm script build on the front end and the rust cargo run together, let me know.

Template

Using Cargo

  • Must have cargo generate installed: cargo install cargo-generate
  • Then use cargo generate jbertovic/svelte-axum-project -n <your-project-name>

Using git template

  • you can also just hit the "use this template" button in green on top of the repo
  • if you have gh cli installed check out --template option

Back end - Rust Axum

  • located in ./back_end
  • serves front end directory
  • middleware for checking authorization header
  • middleware for checking session that user exists
  • store example that holds token secret for authorization
  • /api route example using authorization header
  • /secure route example using sessions for authorization

Note there is no persistance beyond what's held in memory while the application is running

run as cargo run from parent directory and not needed to run inside ./back_end folder

Front end - Svelte

  • Located in ./front_end
  • navbar with login and logout
  • secure page that shows session information once logged in
  • api fetch example, log in not required

run as npm run build from inside the ./front_end directory to build the static serve file directory.

Setup

Install the following NodeJs - Install Rust - Install

Clone the repository

  • cd repository
  • inside the ./front_end folder run npm install to download all module dependencies inside root directory of project
  • inside the ./front_end folder run npm run build to bundle the js/svelte code into public folder
  • inside the top level folder run cargo run to start the the server
  • access in browser at http://localhost:8080/

About

Starting project template for Rust Axum backend and Svelte frontend

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 48.2%
  • Svelte 37.0%
  • JavaScript 8.5%
  • CSS 4.6%
  • HTML 1.7%