regenbogenkarte/docs/development.md
2022-09-14 17:13:08 +02:00

1.4 KiB

Entwicklung

Dieses Dokument beschreibt den Prozess, um diese Anwendung lokal auf deinem PC entwickeln und starten zu können.

Erste Schritte

Wir nutzen primär TypeScript für die Entwicklung der Karte. Aber da jeder JavaScript-Code auch prinzipiell erstmal gültiges TypeScript ist, sind natürlich auch Ergänzungen in JavaScript gerne gesehen.

Für das CSS nutzen wir Tailwind. Das erleichtert uns ein wenig die Entwicklung, aber wenn du damit noch keine Erfahrung hast, würde es auch reichen, gewöhnliches CSS zu schreiben.

Damit der ganze Spaß aber lokal auch läuft, brauchst du Node.js. Empfohlen ist Version 16 oder höher, dieses kannst du über den LTS-Installer auf nodejs.org beziehen.

Sobald Node.js installiert ist, welches den Paketmanager npm beinhaltet, öffne deine Konsole und führe den folgenden Code aus:

git clone https://github.com/Queer-Lexikon/regenbogenkarte.git
npm ci
npm run dev

Du solltest nun eine lokale Version der Karte haben! Besuche localhost:5173 in deinem Browser.

Sobald du fertig bist und den lokalen Server wieder stoppen willst, tippe Ctrl+C in deinem Terminal.

npm ci muss in der Regel nur einmal ausgeführt werden, oder wenn du deinen Branch aktualisierst. Der Befehl lädt die notwendigen Abhängigkeiten für die Regenbogenkarte herunter und installiert diese.