Jetzt starten

Lokale Entwicklung, einfacher.

Was ist Dwell?

Dwell ist ein npm-basiertes Command-Line-Tool für lokale Web-Projektumgebungen. Es organisiert Docker-Services, lokale Domains und ein HTTPS-Gateway über eine gemeinsame Projekt-Konfiguration.

Jetzt starten Dokumentation

Die Grundidee

Eine gemeinsame Grundlage für lokale Entwicklung.

Statt die Infrastruktur für jedes Projekt einzeln einzurichten, beschreibst du sie in einer Konfiguration. Das macht Setups nachvollziehbar und leichter wiederholbar – auch im Team.

Wiederholbare Setups

Eine gemeinsame Konfiguration beschreibt die Umgebung. Unterschiede bei Host-Systemen und Abhängigkeiten bleiben trotzdem relevant.

Lokale Domains

Erreiche deine Projekte über sprechende .localhost-Domains statt über eine Sammlung verschiedener Ports.

Zentrales Routing

Das lokale Gateway leitet Anfragen an die passenden Services weiter und übernimmt die HTTPS-Anbindung.

Optionaler LAN-Zugriff

Gib ein Projekt bei Bedarf im lokalen Netzwerk frei. Die Erreichbarkeit hängt auch von deinem Netzwerk ab.

So funktioniert es

Dwell als zentrale Schicht.

Du steuerst Dwell über die Kommandozeile. Dwell startet die Docker-Services, verwaltet lokale Domains und richtet das HTTPS-Gateway ein. Deine Anwendung und ihre Abhängigkeiten bleiben Teil deines Projekts.

Die wichtigsten Konzepte

Projekt-Konfiguration

Hier wird die Umgebung deines Projekts beschrieben. Diese Datei ist die Grundlage für das Setup.

.dwell/dwell.json

Projekt-Laufzeit

Dwell speichert erzeugte Konfigurationen und Laufzeitdaten projektlokal in diesem Verzeichnis.

.dwell/runtime/

Globales Gateway

Das gemeinsame Gateway verbindet die lokalen .localhost-Domains mit den laufenden Projekt-Services.

~/.dwell/gateway/

Optionaler LAN-Zugriff

Mit aktivierter LAN-Freigabe werden die Routen zusätzlich unter .local bereitgestellt. Das ist keine Internet-Freigabe.

Installation · Release Candidate

Aus dem Repository installieren.

Die RC-Version wird aus einem lokalen Repository-Checkout installiert. Sie ist noch nicht auf npm veröffentlicht.

Installation (aus dem Repository)bash
$ npm ci && npm pack
$ npm install -g ./websign-dwell-1.0.0-rc.1.tgz

Für den Start brauchst du Node.js ab 20.19.0, npm im PATH und eine laufende Docker-Umgebung.

Das erste Projekt

Erstellen, bauen, starten.

Nach der Installation legst du ein Projekt an, baust die Services und startest die lokale Umgebung.

Erstes Projektbash
  1. $ dwell init mein-projekt# Projekt erstellen
  2. $ dwell build# Services bauen
  3. $ dwell up# Umgebung starten