Erste Schritte
Vom Download über Starten, Module hinzufügen, Einstellungen, Anbindung an ein echtes Backend und Design bis zum Update - alles, was Sie am ersten Tag brauchen.
Kaufen Sie auf der Preisseite die Edition, die Sie brauchen, mit PayPal. Es ist ein Einmalkauf, kein Abo.
Mein Konto im Header → Meine Produkte. Die ZIP-Dateien für React, Vue und Next.js enthalten den Editionsordner und das gemeinsame Mock-Backend (initfn-mock) nebeneinander.
initfn-react-1.0.0/
initfn-react/ # React edition
initfn-mock/ # mock backend (found at ../initfn-mock - keep both side by side)Node.js 24 (siehe .nvmrc in jeder Edition) und npm. Für Vanilla nicht nötig.
Erst das Mock-Backend starten, dann die App. Anmelden mit admin / 1234.
cd initfn-mock && npm i && cd ..
cd initfn-react && npm i # initfn-vue for Vue
npm run mock # mock backend http://localhost:4000
npm run dev # React :4001 · Vue :4003 · docs at /docNur mit dem Next-Server starten (Monolith) oder an das Mock-Backend anbinden.
cd initfn-nextjs && npm i
npm run mock # when using the mock backend
npm run dev # http://localhost:4002 · docs at /docKein Build-Schritt. Öffnen Sie die HTML-Dateien in _guide im Browser für Anleitung und Beispielcode und verlinken Sie dann die Ordner css, js und font in Ihren Seiten.
In den Editionen React, Vue und Next.js fügen Sie jedes der 50 Module mit einem Befehl hinzu oder entfernen es - Screens, APIs und Menüs kommen und gehen zusammen.
npm run preset # list modules
npm run preset add social-login mfa # add
npm run preset remove mfa # removeDie Editionen React, Vue und Next.js teilen die Einstellungen auf drei Dateien auf. .env enthält Werte für Entwicklung und Produktion (nichts Geheimes, etwa den Seitennamen), .env.development gilt nur in der Entwicklung, .env.production nur in Produktion. Keine davon kommt ins Git, und Werte nur für Ihren eigenen Rechner gehören in .env.local.
.env # shared, not secret - site name, public IDs
.env.development # dev only - local backend URL, sandbox keys
.env.production # production only - live URL, live keys, analytics ID
.env.local # your machine only (overrides the others)Wenn Sie ein Modul hinzufügen, werden die benötigten Einstellungsschlüssel mit einem erklärenden Kommentar ans Ende der passenden Datei geschrieben, und am Ende sehen Sie, welche Schlüssel Sie noch ausfüllen müssen. Vorhandene Werte werden nie angetastet, und beim Entfernen eines Moduls bleiben sie stehen.
npm run preset add paypal
# -> adds PAYPAL_* keys to .env.development
# and .env.production, then lists keys to fillDie Backend-Adresse ist eine Zeile in der Tabelle in core/config/apiConfig.js und eine Zeile in .env.development (in Produktion .env.production). Der Screen-Code bleibt gleich.
# .env.development (production: .env.production)
BACKEND_API_URL=http://your-backend:8080initfn-mock/openapi.yaml beschreibt die API, die das Frontend erwartet. Geben Sie sie Ihrem Backend-Team - ein Backend, das so antwortet, lässt sich ohne Codeänderung anbinden.
Styles sind in drei Ebenen aufgeteilt. Werte wie Farben, Schriften, Eckenradius und Schatten stehen in initfn-token.css, das Aussehen kleiner UI wie Buttons, Eingabefelder, Karten und Blöcke in initfn-base.css, größere Designs wie Seiten und Abschnitte in initfn-global.css. Für nur eine neue Markenfarbe ändern Sie lediglich --color-brand-* am Ende der Token-Datei.
src/core/style/ # Vanilla: css/ · font/ · image/
css/initfn-token.css # values - colors, fonts, radius, shadows
css/initfn-base.css # small UI, components, blocks
css/initfn-global.css # pages and sections
font/ image/Geben Sie einen Entwurf oder die gewünschte Anmutung vor und bitten Sie die KI, zuerst den Design-Skill Ihrer Edition zu lesen. Der Skill legt für jede Art von Anfrage fest, welche Datei geändert wird - so bearbeitet die KI diese drei Dateien und lässt den Screen-Code in Ruhe.
.claude/skills/ssr-design/ # Next.js
.claude/skills/csr-design/ # React
.claude/skills/vue-design/ # Vue
.claude/skills/vanilla-design/ # VanillaCSS wird mit einer Regel pro Zeile geschrieben (nur die Token-Datei hat Zeilenumbrüche), und VS Code räumt beim Speichern automatisch auf. Von Pretendard werden nur die Teile geladen, die eine Seite braucht - die Schriften für den ersten Bildschirm sind etwa 1MB groß. In React, Vue und Next.js lädt die gemeinsame Image-Komponente Bilder erst bei Bedarf und liefert sie schlank als avif/webp aus.
npm run format # tidy CSS - one rule per line
node scripts/format-css.mjs # VanillaIn den Editionen React, Vue und Next.js kopieren Sie den Ordner .preset aus der neuen ZIP-Datei über den .preset Ihres Projekts und führen dann update aus. In der Liste markiert ⬆ installierte Module mit neuer Version und 🆕 neue Module. Von Ihnen geänderte Dateien werden nie überschrieben - die neue Version liegt daneben als .preset-new; vergleichen, zusammenführen und danach löschen.
# 1. copy .preset from the new zip over your project's .preset
npm run preset # 2. list - ⬆ update available · 🆕 new module
npm run preset update # 3. update installed modules
npm run preset add <name> # 4. add a new module
npm run lint && npm test && npm run buildWelche Module Sie in welcher Version hinzugefügt haben, steht in preset.lock.json im Projektstamm. Die Datei liegt außerhalb von .preset, damit das Protokoll das Überschreiben dieses Ordners übersteht - committen Sie sie ebenfalls ins Git.
Wenn Sie auch Verbesserungen am Basiscode wie core und shared übernehmen wollen, legen Sie aus der ZIP-Datei ein Git-Repository an und behalten das unveränderte Original auf einem Branch initfn. Ihre eigene Arbeit machen Sie auf main.
git init && git add . && git commit -m "initfn 1.0.0"
git branch initfn # untouched originalLaden Sie die neue ZIP-Datei herunter, überschreiben Sie damit den Branch initfn, mergen Sie ihn in main und gleichen Sie mit npm run preset update die installierten Module an. Nur Stellen, die Sie selbst geändert haben, erscheinen als Konflikt. Was sich geändert hat, steht in den Release Notes.
git switch initfn
# unzip the new version over it (keep node_modules and your .env files)
git add -A && git commit -m "initfn 1.1.0"
git switch main && git merge initfn
npm run preset update # sync installed modulesJede Edition hat dieselben Befehlsnamen.
npm run lint && npm test # rules and unit tests
npm run build # production build
npm run test:e2e # browser E2EDas Deployment beschreibt die Entwickler-Anleitung in der App (/doc). Wenn Sie ein Endprodukt deployen oder ausliefern, legen Sie THIRD_PARTY_NOTICES.md (Open-Source-Hinweise) aus der Edition bei.
Die vollständige, ausführliche Anleitung liegt dem Projektarchiv bei. Diese Seite deckt nur ab, was Sie am ersten Tag brauchen. Alles andere - Installation, Einstellungen, Komponenten, Module und Deployment - finden Sie im heruntergeladenen Archiv: in der integrierten Guide-Seite (7 Sprachen), der README und den Dokumenten für KI-Coding-Tools (AGENTS.md).
Sehen Sie in FAQ und Lizenz nach oder schreiben Sie uns an numerxlab@gmail.com.