create-geocities-app

██║ ██║███████╗███████║ ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝╚═╝ ╚═╝ ╚═╝╚══════╝╚══════╝

geocities-boilerplate ✨ Welcome to 1996 ✨ 🌐 View Live DemoWhat is this?geocities-boilerplate is a CLI tool that generates a fully self-contained, retro 1990s Geocities-style personal website. Think neon colors, blinking text, animated star trails, marquee banners, visitor counters, and guestbooks — all of it, generated instantly with a single command.The generated site is pure static HTML, CSS, and vanilla JavaScript. No build tools, no frameworks, no dependencies. Just open index.html in any browser and relive the golden age of the web.Quick Start# one-shot with pipx (recommended — no permanent install) pipx run create-geocities-app my-site

# or install permanently pip install create-geocities-app create-geocities-app my-site Then open my-site/index.html in your browser. That's it!Every Way to Run ItPick your language or runtime — all produce the same site.Python / PyPI# one-shot with pipx (recommended) pipx run create-geocities-app my-site

# or install permanently pip install create-geocities-app create-geocities-app my-site Node.js / npm# one-shot, no install npx create-geocities-app my-site

# or install globally npm install -g create-geocities-app create-geocities-app my-site Ruby / RubyGemsgem install create-geocities-app

create-geocities-app my-site Rust / Cargocargo install create-geocities-app create-geocities-app my-site PHP / Composer# global install composer global require geocities-app/create-geocities-app create-geocities-app my-site

# or as a project scaffold composer create-project geocities-app/create-geocities-app my-site Deno / JSR# run without installing deno run --allow-read --allow-write jsr:@geocities/create-app my-site

# or compile to a native binary first deno compile --allow-read --allow-write --output create-geocities-app jsr:@geocities/create-app ./create-geocities-app my-site Go# run without installing go run github.com/sugardaddyapp/geocities-boilerplate/go@latest my-site

# or install the binary go install github.com/sugardaddyapp/geocities-boilerplate/go@latest create-geocities-app my-site All variants accept the same flags:

Flag Meaning

my-site Output directory name (default: my-geocities-site)

-y / --yes Skip all prompts and use defaults

DemoLive demo: https://sugardaddyapp.github.io/geocities-boilerplate/The demo is generated with all options enabled (neon theme, sparkle cursor, falling stars, all 5 pages). It is automatically rebuilt and deployed to GitHub Pages on every push to main.Interactive SetupWhen you run create-geocities-app my-site, you'll be walked through a series of prompts:

# Prompt Type Description

1 Site name text Your homepage title, e.g. CoolDude's Homepage

2 Your name text Displayed in headers, footers, and contact sections

3 Color theme select Choose from 5 retro color palettes (see below)

4 Extra pages multi

forest

windows #008080 #000000 #000080 #000080 Classic Windows 95

Pages🏠 index.html — HomepageEvery generated site includes a homepage with: Marquee banner — scrolling welcome text (CSS animation, no deprecated <marquee> tag) Rainbow animated site title — CSS hue-rotate animation cycles through all colors Neon-pulsing headings — text-shadow breathes in and out "What's New" section — with blinking NEW badges Under Construction section — animated yellow/black caution tape Sidebar — navigation, live clock, spinning globe, visitor counter, web ring Web ring widget — retro navigation to prev/home/next sites Footer — "Best viewed in Netscape Navigator" badge, copyright 👤 about.html — About Me Fun Facts list — blinking star bullet points Interests grid — styled badge chips for hobbies Favorites table — a retro-styled table of favorite things (music, movies, games, etc.) Contact section — email and guestbook links 🖼️ gallery.html — Photo Gallery Photo of the Month spotlight at the top 3-column image grid — each item has thick beveled Windows-95-style borders Captions in Comic Sans below each image Lightbox viewer — click any photo to open it full-size in an overlay; press ESC or click outside to close Placeholder images pre-filled — replace with your own 📖 guestbook.html — Guestbook Sign form — fields for name, email, website, location, and message Fake previous entries — pre-populated with period-authentic guestbook posts (fully editable) Client-side submit — shows a thank-you alert and resets the form Note explaining how to add a real backend (Formspree, Netlify Forms, etc.) 🔗 links.html — Cool Links Links organized into categories: Friends, Games, Web & Tech, Art, News Blinking animated bullets before each link Description text below each link "Request Link Exchange" email button Effects ReferenceCursor Effects

Effect What it does

Sparkle ✨ Random glitter glyphs (✦, ✧, ★, ·) spawn