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