Bevor wir mit dem eigentlichen Haushaltsbuch-Projekt beginnen, richten wir die nötigen Werkzeuge ein: Node.js und ein sauberes Projekt-Grundgerüst.

Node.js installieren

Node.js ist die JavaScript-Laufzeitumgebung, auf der unser Projekt aufbaut – laden Sie die aktuelle LTS-Version von nodejs.org herunter, oder nutzen Sie einen Versionsmanager wie nvm. Prüfen Sie die Installation:

node --version
npm --version

Editor-Empfehlung

Ein Code-Editor mit JavaScript-Unterstützung genügt vollkommen – Visual Studio Code (kostenlos) bietet von Haus aus Syntax-Highlighting, Autovervollständigung und sogar eingebaute Fehlerprüfung für einfache Tippfehler, ganz ohne Zusatz-Konfiguration.

Das Haushaltsbuch-Projekt anlegen

mkdir haushaltsbuch-app
cd haushaltsbuch-app
npm init -y

npm init -y erzeugt eine package.json mit sinnvollen Standardwerten – die zentrale Konfigurationsdatei jedes Node.js-Projekts: Name, Version, Einstiegspunkt und, wie wir gleich sehen, auch die Modul-Art.

{
  "name": "haushaltsbuch-app",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "scripts": {
    "start": "node src/index.js"
  }
}

Zwei manuelle Ergänzungen gegenüber dem npm init-Standard: "private": true verhindert ein versehentliches Veröffentlichen auf npm, und "type": "module" ist die wichtigste Zeile in dieser Datei – dazu gleich mehr.

CommonJS vs. ES Modules: eine Weichenstellung am Projektanfang

Node.js unterstützt HEUTE zwei Modulsysteme nebeneinander. Historisch gewachsen ist CommonJS (require()/module.exports) – der Standard von Node.js' Anfängen. Der moderne, auch im Browser native Standard sind ES Modules (import/export). Mit "type": "module" in package.json legen wir fest, dass ALLE .js-Dateien dieses Projekts ES-Module-Syntax verwenden – das ist die Syntax, die wir in diesem Tutorial durchgehend nutzen, da sie moderner, im Browser identisch nutzbar und daher die bessere Grundlage fürs Lernen ist.