commit 1ab026c35c7e7b3b8cfb294dc94bbd188f77c801 Author: Alexander Schmidt Date: Wed Jan 28 07:02:55 2026 +0100 initial commit diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..5b16cf4 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,112 @@ +# AGENTS.md - AI Assistant Context + +Dieses Dokument hilft AI-Assistenten (Amp, Copilot, etc.) das Projekt zu verstehen. + +## Projekt-Überblick + +**dgray.io** ist eine Kleinanzeigen-PWA mit Monero-Bezahlung. + +- **Status**: Early Development (Frontend-only) +- **Ziel**: Anonyme, dezentrale Marktplatz-Alternative + +## Tech-Stack + +| Layer | Technologie | +|-------|-------------| +| Frontend | Vanilla JS, Web Components, CSS Custom Properties | +| Routing | Hash-basierter Client-Side Router (`js/router.js`) | +| i18n | Custom System (`js/i18n.js`), JSON-Dateien in `/locales/` | +| Theming | CSS Variables, Dark/Light Mode | +| Backend | Geplant: Directus | + +## Häufige Befehle + +```bash +# Lokaler Entwicklungsserver +python3 -m http.server 8080 + +# Oder mit Live-Reload +npx live-server + +# Git Push (Token in URL) +git push origin master +``` + +## Dateistruktur + +``` +js/ +├── app.js # Entry, lädt i18n, dann Shell +├── router.js # Hash-Router mit :params +├── i18n.js # t('key'), subscribe(), updateDOM() +└── components/ + ├── app-shell.js # Layout, registriert Routes + ├── app-header.js # Header (Theme-Toggle, Lang-Dropdown) + ├── app-footer.js # Footer + └── pages/ # Seiten als Web Components + +css/ +├── fonts.css # @font-face Definitionen (Inter, Space Grotesk) +├── variables.css # CSS Custom Properties (Farben, Spacing) +├── base.css # Reset, Container +└── components.css # UI-Komponenten (Buttons, Cards, etc.) + +assets/ +└── fonts/ # Self-hosted Fonts (Inter, Space Grotesk) + +locales/ +├── de.json # Deutsch (Fallback) +├── en.json +└── fr.json +``` + +## Konventionen + +### Web Components +- Custom Elements mit `class extends HTMLElement` +- Styles als `