From 814a9eb3268438f00a1a2d0e427b2972caaf9138 Mon Sep 17 00:00:00 2001 From: Stefan Koelle Date: Sat, 15 Aug 2026 21:17:52 +0200 Subject: [PATCH] README.md --- README.md | 48 ++++++++++++++++++++++++------------------------ TODO.md | 10 ++++++++++ 2 files changed, 34 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index 2ca8b57..4772e95 100644 --- a/README.md +++ b/README.md @@ -1,35 +1,35 @@ -# 28k8.moonweb.org - tHE tEMPLE bBS Retro Hub (v2) +# 🖥️ 28k8.moonweb.org - tHE tEMPLE bBS Retro Hub (v2) A 90s BBS/demoscene retro hub, built with Astro + React Islands, deployed -on Cloudflare Pages. No backend, no PHP, no database, no tracking. +on Cloudflare Pages. No backend, no PHP, no database, no tracking. 🚫 -## v2 highlights -- The colored TEMPLE ANSI banner now actually renders on the main menu. -- Disconnect works correctly (clears state, returns to the intro screen). -- SkyLINE has a visible blue accent + a real generated header image. -- 10 full ASCII banners with color gradients across every page, an 8-item +## ✨ v2 highlights +- 🎨 The colored TEMPLE ANSI banner now actually renders on the main menu. +- 🔌 Disconnect works correctly (clears state, returns to the intro screen). +- 🔵 SkyLINE has a visible blue accent + a real generated header image. +- 🎭 10 full ASCII banners with color gradients across every page, an 8-item ANSI-art gallery, and real net-list content from the original screenshots. -- Lots more content: Tropic DREAMs (all 4 real releases), SkyLINE (+3), +- 📚 Lots more content: Tropic DREAMs (all 4 real releases), SkyLINE (+3), Kosmos Design (7, new), ESPRIT (4, new), MOD Files tracklist. -## Start here -1. PRD.md - requirements + v1.4 changelog -2. SPEC.md - technical spec, what changed and why -3. PLAN.md - phase-by-phase remaining work +## 🗺️ Start here +1. 📋 PRD.md - requirements + v1.4 changelog +2. 📐 SPEC.md - technical spec, what changed and why +3. 📅 PLAN.md - phase-by-phase remaining work -## Quick start -``` +## 🚀 Quick start +```bash npm install npm run dev # http://localhost:4321 npm run build # -> dist/ npm run preview # serve the production build locally ``` -## Deployment +## ☁️ Deployment Cloudflare Pages, connected directly to this repo. Build command `npm run build`, output directory `dist`. -## Pre-Build System +## 🔄 Pre-Build System Das Pre-Build-System lädt vor jedem Build externe Daten (JSON) und schreibt sie nach `src/data/`. Die JSON wird committed, sodass der Build nicht von @@ -51,17 +51,17 @@ Aktive Stages: | `mods` | `tools/fetch_mods.py` | `src/data/mods.json` | MOD-Metadaten von moonweb.org | Neuen Stage hinzufügen: -1. `tools/fetch_.py` erstellen (Output: `src/data/.json`) -2. Case-Block in `prebuild.sh` ergänzen -3. `npm run build` ruft automatisch `prebuild.sh` auf +1. 🐍 `tools/fetch_.py` erstellen (Output: `src/data/.json`) +2. 🔧 Case-Block in `prebuild.sh` ergänzen +3. 🏗️ `npm run build` ruft automatisch `prebuild.sh` auf -## WelcomeBanner (Startseite) +## 🎬 WelcomeBanner (Startseite) Das "THE TEMPLE BBS"-Logo auf der Startseite wird als CP437-Text mit Typewriter-Animation dargestellt. Der Text kommt aus einer echten CP437-Datei und wird mit einem IBM-VGA-Webfont gerendert. -### Dateien +### 📁 Dateien | Datei | Zweck | |---|---| @@ -72,7 +72,7 @@ CP437-Datei und wird mit einem IBM-VGA-Webfont gerendert. | `public/fonts/Px437_IBM_VGA_8x16.ttf` | Font als Fallback | | `src/styles/global.css:2` | `@font-face`-Definition | -### Warum zwei Textdateien? +### 🤔 Warum zwei Textdateien? Node.js unterstützt `cp437` nicht in `TextDecoder`. Die Original-Datei wird daher per Python in UTF-8 konvertiert und die `.txt`-Datei mit @@ -86,7 +86,7 @@ with open('source-assets/welcome-utf8.txt','w',encoding='utf-8') as f: f.write(d " ``` -### Animation anpassen +### ⏱️ Animation anpassen In `src/components/WelcomeBanner.astro`, Zeile 24-26: @@ -102,7 +102,7 @@ const HARD_PAUSES: [number, number][] = [[34, 400], [98, 350]]; Position 34 ≈ Mitte der 1. Zeile, Position 98 ≈ Mitte der 2. Zeile. Werte an Text anpassen wenn sich die Zeilenlängen ändern. -### Font +### 🔤 Font `Px437 IBM VGA 8x16` von int10h.org (Oldschool PC Font Pack v2.2, CC BY-SA 4.0). Enthält 288 Glyphs inkl. aller CP437-Block-Zeichen diff --git a/TODO.md b/TODO.md index 6116d73..d08b5f1 100644 --- a/TODO.md +++ b/TODO.md @@ -18,6 +18,16 @@ Stand: 15.08.2026 | Referenz: PLAN.md, SPEC.md, PRD.md - [ ] BANNER_KOSMOS — pc/kosmos-design.astro - [ ] BANNER_ANSI — Header auf ansi-art.astro selbst +### Dependency Updates (Renovate) +- [x] chiptune3 → 0.8.8 (15.08.2026) +- [x] actions/checkout → v7 (15.08.2026) +- [x] actions/setup-node → v7 (15.08.2026) +- [ ] React → v19 (erst prüfen ob `@astrojs/react` kompatibel ist) +- [ ] Astro monorepo → v5 (Major, ausführlich testen) +- [ ] Node.js → v24 (Major, nach lokalem Test) +- [ ] TypeScript → v7 (Major, nach `npm run build` Test) +- [ ] GitHub Artifact Actions → Major (CI manuell prüfen) + ### Sonstiges - [x] sitemap.xml — `/bbs/fido/cds/` Eintrag korrigiert (15.08.2026) - [x] `skyline-header.png` — wieder eingebaut in skyline.astro (15.08.2026)