bytemalte_de – Community Chat & Projekt-Portfolio
Dies ist ein Fullstack-Projekt für eine moderne Community-Plattform, entwickelt mit:
Leptos (0.8) – Web-Framework aus Rust (Frontend & SSR)
cargo-leptos – Fullstack-Build-Tool
Axum – Webserver-Framework
SQLite & SQLx – Datenbank für Chat & Benutzer
File-based CMS – JSON-basiertes System für Projekt-Verwaltung
Projekt-Features
Echtzeit-Chat: Benutzerregistrierung und Gruppenchat mit SQLite-Backend.
Projekt-Portfolio: Dynamische Anzeige von Projekten direkt aus einer projects.json.
Infinite Scroll: Performantes Nachladen von Inhalten auf der Startseite.
Server Side Rendering (SSR): Schnelle Ladezeiten und SEO-Optimierung.
Projekt-Setup
Voraussetzungen & Tools Stelle sicher, dass Rust installiert ist. Installiere zusätzlich die benötigten Komponenten:
rustup target add wasm32-unknown-unknown cargo install cargo-leptos cargo install sqlx-cli --no-default-features --features sqlite
SASS Compiler: Fedora: sudo dnf install dart-sass Oder via npm: npm install -g sass
Datenbank & Umgebung Erstelle eine .env Datei im Hauptverzeichnis: DATABASE_URL="sqlite:community.db"
Initialisiere die Datenbank und führe Migrationen aus: sqlx db create sqlx migrate run
CMS Konfiguration (Projekte) Die Projekte auf der Startseite werden über die Datei projects.json gesteuert. Du kannst Projekte hinzufügen oder ändern, ohne den Code neu zu kompilieren. Die Datei muss im Hauptverzeichnis liegen.
Struktur der projects.json: [ { "id": 1, "title": "Projekt Name", "description": "Beschreibung...", "image_url": "/assets/bild.png", "download_url": "#", "code_url": "https://..." } ]
Entwicklungsserver starten
Starte das Projekt mit Hot-Reload: cargo leptos watch
Nach erfolgreicher Kompilierung ist die Anwendung unter http://127.0.0.1:3000 erreichbar.
Zusätzliche Konfiguration
Füge folgende Konfiguration in .cargo/config.toml hinzu, um das WASM-Krypto-Backend (bcrypt) zu aktivieren:
[target.wasm32-unknown-unknown] rustflags = ["--cfg", "getrandom_backend="wasm_js""]
Produktion / Release Build
Erzeuge eine optimierte Release-Version: cargo leptos build --release
Dieser Befehl erstellt:
Die Server-Binärdatei unter target/release/bytemalte_de
Das Frontend-Paket (WASM/JS/CSS) unter target/site
Deployment auf einem entfernten Server (Ubuntu 24.04 VPS)
Nach dem Build benötigst du auf dem Zielserver folgende Dateien:
die Binärdatei (bytemalte_de)
den Ordner site/
projects.json
community.db
.env
Beispielhafte Verzeichnisstruktur: bytemalte_de/ ├── site/ ├── projects.json ├── community.db └── .env
Exportiere die Umgebungsvariablen (z. B. in einem Systemd-Service): export LEPTOS_OUTPUT_NAME="bytemalte_de" export LEPTOS_SITE_ROOT="site" export LEPTOS_SITE_PKG_DIR="pkg" export LEPTOS_SITE_ADDR="0.0.0.0:3000" export DATABASE_URL="sqlite:community.db"
Anwendung starten: ./bytemalte_de
Lizenz & Urheberrecht
Dieses Projekt basiert auf dem Leptos Axum Starter Template. Die spezifische Chat-Logik, das JSON-CMS, das Styling und UI-Design wurden individuell für bytemalte_de entwickelt.
Entwickelt mit ❤️ von bytemalte