# IDEA.md – en egen lekplats för design och 3D i webbläsaren Det här är en fristående uppdragsbeskrivning. Ge den i sin helhet till Claude Code (eller ett liknande verktyg) för att bygga en egen sajt. Den bygger på Burn Tokens Repeat, en lekplats för grafisk design, typografi och 3D som designades i Claude Design, byggdes med Claude Code och fick sin ikon av Codex. ## 1. Vad som ska byggas En statisk sajt som är en lekplats: en påhittad byrå med en stark grafisk stil (Burn Tokens Repeat är inspirerad av TDR – The Designers Republic), och en avdelning med interaktiva 3D-experiment i webbläsaren. Den ska gå snabbt, fungera utan nät och inte spara något om besökaren utöver det som syns. I Burn Tokens Repeat: - **en startsida, en 404-sida och en byråsida** med var sin grafiska stil - **tre designsystem**, var och ett med egna färger, typsnitt och komponenter, som en sida väljer genom vilka stilmallar den laddar - **3D-experiment i three.js**: sfärer längs kurvor, spiraler, fält, en kub, ett labb som läser in 3D-modeller, med en panel för parametrar - **ett renderarkiv**: ett galleri med miniatyrer och en ljuslåda i full upplösning - **en installerbar webbapp** med en offline-sida - **ingen kaka**, och en skylt som visar vad sajten sparar i webbläsaren och kan ta bort det ## 2. Stack och arkitektur Det som **spelar roll** är markerat; resten går att byta. - **PHP utan ramverk och utan byggsteg.** Varje sida är en kort fil som sätter några variabler (titel, beskrivning, stilmallar, skript, Open Graph) och tar in gemensamma delar för huvud, topprad och sidfot. - **Viktigt: rena adresser och absoluta sökvägar.** Inga `.php` eller `.html` i länkar. `.htaccess` omdirigerar gamla former och skriver om `/sida/` till `sida.php`. Allt som hämtas – bilder, modeller, skript – har en absolut sökväg. - **Designsystemen som separata stilmallar** med egna `:root`-variabler, och delade stilmallar för toppraden och 3D-panelen. - **three.js via en importmap** med en fast version. En gemensam modul kopplar renderaren och kameran till sidans scen och hanterar storleksändring. - **En service worker**: sidor nätverk först med en offline-sida som reserv, egna filer cachade och uppdaterade i bakgrunden, three.js från CDN cachat för alltid. Video och delhämtningar cachas aldrig. Räkna upp en version när cachningen ändras. ## 3. Beslut som visade sig avgörande **Rena adresser från början.** Med `/3d/lab/` i stället för `/3d/lab.php` går relativa sökvägar sönder. Bestäm att allt är absolut innan första sidan skrivs. **Skärmbilder av varje sida automatiskt.** Ett skript tar en bild av varje sida i en webbläsare utan fönster, med grafikkortet påslaget så att WebGL ritar, och med längre väntetid för tunga scener. Bilderna blir både granskningsunderlag och förhandsbilder. **Gammal kod kan få nytt liv.** Sfärberäkningarna började som ett VB-program från början av 2000-talet som genererade objekt till POV-Ray, och 3D-labbet som en labbuppgift i C med IRIS GL på SGI från 1998. Ge kodagenten den gamla koden eller beskrivningen och låt den översätta till JavaScript och three.js. **Ett bildflöde för galleriet.** Lägg in en PNG, kör ett skript som gör WebP i full storlek och en miniatyr, och lägg till ett block i galleriet. Ljuslådan härleder den stora bilden ur miniatyrens sökväg. **Rensa typsnitten.** Ett skript läser vilka tecken sidorna faktiskt visar – och följer `include` till de gemensamma delarna – och tar bort de typsnittsdelar och filer som inget behöver. **Var öppen om lagringen.** Skylten listar exakt vilka nycklar sajten sparar, och dess knapp tar bort dem och sajtens cachar. Uppdatera listan när ny lagring tillkommer. ## 4. Fallgropar - **Relativa sökvägar under rena adresser** pekar en katalog fel. Använd absoluta. - **iOS 26+ lägger ett sudd över överkanten** i en webbapp från hemskärmen. Den vanliga lösningen – en fast, ogenomskinlig behållare över hela skärmen – fungerade inte här. Det som fungerade var vanligt dokumentflöde med en topprad som klistras fast överst (`position: sticky`). Prova på en riktig telefon, och lägg till ikonen på hemskärmen på nytt efter ändringar i manifestet. - **Apache har ett eget `/icons/`-alias.** Lägg appikonerna någon annanstans. - **WebGL i en webbläsare utan fönster** ritar inget utan grafikkort. Slå på det i skärmbildsskriptet. - **Länka aldrig till de gemensamma delarna direkt.** Spärra katalogen i `.htaccess`. ## 5. Krav och mätningar - Inga kakor; lagringen begränsad och redovisad. - Sajten fungerar offline efter första besöket. - Förhandsbilder för delning (1200 × 630) för varje sida. ## 6. Så verifieras det - Lokalt i Docker med samma Apache och `.htaccess` som i produktion. - Skärmbilder av varje sida efter ändringar, granskade av en människa. - Webbappen och iOS-beteendet på en riktig telefon. ## 7. Arbetssätt - **Design först** i ett designverktyg: sidorna och designsystemen. - **Ett experiment i taget**, med en befintlig sida som mall. - **Skriv ner konventionerna** (sökvägar, variabler, designsystem) i projektets instruktioner. ## 8. Prompten > Bygg en lekplats för grafisk design och 3D i webbläsaren: en påhittad [byrå] med en stark grafisk stil, [tre] egna designsystem och en avdelning med interaktiva 3D-experiment i [three.js]. [PHP] utan ramverk och utan byggsteg, rena adresser, installerbar och offline, och inga kakor. > > Läs hela IDEA.md nedan först. > > Börja med designen och designsystemen, och ta en skärmbild av varje sida efter varje ändring. > > [klistra in IDEA.md här]