From d6b31101c4894712219e1969ae237b704a94bf86 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Malte=20Schr=C3=B6der?= Date: Tue, 23 Dec 2025 16:09:13 +0100 Subject: [PATCH] new Readme --- README.md | 66 ++++++++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 53 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 1e629b6..81cc3db 100644 --- a/README.md +++ b/README.md @@ -1,25 +1,65 @@ -# Development +# mflow -Your new bare-bones project includes minimal organization with a single `main.rs` file and a few assets. +**mflow** ist eine leichte, in Rust geschriebene Anwendung zur Verwaltung von Projekten und Notizen. Sie basiert auf dem [Dioxus](https://dioxuslabs.com/)-Framework und unterstützt sowohl Desktop- als auch Web-Umgebungen. -``` -project/ -├─ assets/ # Any assets that are used by the app should be placed here -├─ src/ -│ ├─ main.rs # main.rs is the entry point to your application and currently contains all components for the app -├─ Cargo.toml # The Cargo.toml file defines the dependencies and feature flags for your project -``` +## 🚀 Funktionen -### Serving Your App +* **Projektverwaltung:** Erstelle, bearbeite und lösche Projekte einfach über die Seitenleiste. +* **Live-Editor:** Bearbeite Projekttitel und Inhalte in Echtzeit. +* **Automatische Speicherung:** + * **Desktop:** Speichert Daten automatisch in einer `projects.json` Datei im Arbeitsverzeichnis. + * **Web:** Nutzt den `LocalStorage` des Browsers, damit deine Daten erhalten bleiben. +* **Sicherheitsabfrage:** Bestätigungsdialog beim Löschen von Projekten, um Datenverlust zu vermeiden. +* **Cross-Platform:** Läuft nativ auf dem Desktop und im Browser (WASM). -Run the following command in the root of your project to start developing with the default platform: +## 🛠️ Technologien + +* **Sprache:** [Rust](https://www.rust-lang.org/) (Edition 2021) +* **UI Framework:** [Dioxus](https://dioxuslabs.com/) (v0.7.1) +* **Daten-Serialisierung:** `serde` & `serde_json` +* **Storage (Web):** `gloo-storage` + +## 📦 Installation & Nutzung + +Stelle sicher, dass du [Rust](https://rustup.rs/) und die [Dioxus CLI](https://dioxuslabs.com/learn/0.6/getting_started) installiert hast. ```bash -dx serve +# Dioxus CLI installieren (falls noch nicht vorhanden) +cargo install dioxus-cli ``` -To run for a different platform, use the `--platform platform` flag. E.g. +### Projekt klonen ```bash +git clone https://github.com/dein-username/mflow.git +cd mflow +``` + +### 🖥️ Desktop starten +Um die Anwendung als native Desktop-App zu starten: + +```bash +# Mit Dioxus CLI (empfohlen, unterstützt Hot-Reloading) dx serve --platform desktop + +# Oder klassisch mit Cargo +cargo run --features desktop ``` +### 🌐 Web-Version starten +Um die Anwendung im Browser zu starten: + +```bash +dx serve --platform web +``` +Die Anwendung ist dann unter `http://localhost:8080` erreichbar. + +## 📂 Projektstruktur + +* `src/main.rs`: Einstiegspunkt der Anwendung. +* `src/ui.rs`: Enthält die Hauptlogik und UI-Komponenten (`Hero` Component). +* `assets/`: Statische Dateien wie CSS und Icons. +* `Dioxus.toml`: Konfiguration für das Dioxus-Tooling. + +## 📝 Lizenz + +Dieses Projekt wurde erstellt von [malxte].