https://github.com/oxide-byte/rust-berlin-leptos
Simple Clone to show the same Site of Rust-Berlin https://berline.rs/ with different Frameworks
https://github.com/oxide-byte/rust-berlin-leptos
leptos rust
Last synced: 23 days ago
JSON representation
Simple Clone to show the same Site of Rust-Berlin https://berline.rs/ with different Frameworks
- Host: GitHub
- URL: https://github.com/oxide-byte/rust-berlin-leptos
- Owner: oxide-byte
- License: mit
- Created: 2025-02-09T13:07:50.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-03-16T16:55:17.000Z (about 1 year ago)
- Last Synced: 2025-03-16T17:34:05.696Z (about 1 year ago)
- Topics: leptos, rust
- Language: Rust
- Homepage: https://berline.rs/
- Size: 656 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# Rust - Berlin Hack and Learn Challenge
## Purpose
This implementation is a adaptation of the Rust UserGroup **Rust Hack and Learn** Berlin
challenge: https://github.com/andreasklostermaier/halreslib in different Frameworks.
My choice **Leptos** as Frontend.
Link to the meetup group: https://berline.rs/
Even whe most of features are implemented and functional, there is still room for progress...
## Implementation
SALT = (S)urrealDB (A)xum (L)eptos (T)ailwind + GraphQL
The Frameworks in use:
Frontend:
* Leptos 0.8.14
* Thaw 0.5.0-Beta
* Tailwind 4.0
* GraphQL Query + Mutation + Subscription
Backend:
* Axum 0.8.3
* Tower 0.5.2 (Static Page Server)
* async-graphql (GraphQL)
Database:
* SurrealDB
## Installation / Preparation
* Rust: https://www.rust-lang.org/tools/install
* Trunk: https://trunkrs.dev/guide/getting-started/installation.html
* TailwindCss: https://tailwindcss.com/docs/installation/using-vite
PS: For TailwindCss I use the Mac Brew option:
```shell
brew update
brew install tailwindcss
```
## Running
The implementation uses Trunk to generate and run the Client Side Pages. It includes Hot Reloading
```bash
trunk serve --open
```
## Build
```bash
trunk build --release --public-url "/web"
```
The files generated in the client folder /dist can be moved on the
Server side to the folder /static. To access to the files from Axum
you need to manually adapt in the index.html file the relative path
for the links as the wasm file:
Example:
href="rust-berlin-leptos-7a6a9f219c87d073.js" --> href="/web/rust-berlin-leptos-7a6a9f219c87d073.js"
## Starting the Backend:
```bash
cd server
cargo run
```
The different links on the Backend side:
```text
Server on: http://127.0.0.1:8080
Leptos client on: http://127.0.0.1:8080/web
Graphiql on: http://127.0.0.1:8080/graphiql
Playground on: http://127.0.0.1:8080/playground
```
## Security
There are currently 2 users implemented with KeyCloak.
- admin@demo.com:password
- user@demo.com:password
## Improvements
- Review SurrealDB specially for SQL Injection and Query Builder
- Review and Optimize code for removing .clone()
- Review and Optimize Signals
- Review and Optimize Component Communication
- Fixing Loging / Refresh actions
- Fixing Error Handling / Server Authority 401/403
- Fixing bugs ;-)
- ...
## Bonus
A module for using Ratatui is under client-ratatui
## Features to plan:
- Add a Security Layer
## Links
Leptos Documentation:
https://book.leptos.dev/
For playing with Tailwind:
https://play.tailwindcss.com/
