🌐 geocities-boilerplate

Scaffold a complete 1990s Geocities-themed static website in seconds.

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

         geocities-boilerplate  ✨  Welcome to 1996  ✨

🌐 View Live Demo

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.

npx create-geocities-app my-site

Then open my-site/index.html in your browser. That's it!

Pick your language or runtime — all produce the same site.

# one-shot, no install
npx create-geocities-app my-site

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

# 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

gem install create-geocities-app
create-geocities-app my-site

cargo install create-geocities-app
create-geocities-app my-site

# 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

# 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

# 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:

Live 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.

When you run npx create-geocities-app my-site, you'll be walked through a series of prompts:

npx create-geocities-app my-site --yes

my-site/
├── index.html        ← Homepage
├── about.html        ← About Me (if selected)
├── gallery.html      ← Photo Gallery with lightbox (if selected)
├── guestbook.html    ← Guestbook (if selected)
├── links.html        ← Cool Links (if selected)
├── css/
│   └── style.css     ← Full retro stylesheet (theme-specific)
└── js/
    └── main.js       ← All JS effects (counter, cursor, music, etc.)

Zero runtime dependencies in the generated output. Every file is self-contained and works offline.

Choose a theme during setup. Each theme controls background, text, link, and accent colors throughout the entire site.

Every 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

• 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

• 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

• 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 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

To host your generated site on GitHub Pages:

1. Create a new GitHub repository
2. Copy the contents of your generated folder into it
3. Push to main
4. Go to Settings → Pages → Source → Deploy from a branch → main → / (root)
5. Your site is live at https://<username>.github.io/<repo-name>/

geocities-boilerplate/
├── .github/workflows/
│   └── deploy-demo.yml    # Auto-deploys demo/ to GitHub Pages
├── bin/
│   └── cli.js             # CLI entry point with ASCII banner
├── src/
│   ├── generator.js       # Core: reads templates, interpolates vars, writes files
│   ├── prompts.js         # Interactive prompts using `prompts` package
│   └── themes.js          # 5 color palette definitions
├── templates/             # Source templates (shared across all ports)
│   ├── index.html
│   ├── about.html
│   ├── gallery.html
│   ├── guestbook.html
│   ├── links.html
│   ├── css/style.css
│   └── js/main.js
├── python/                # PyPI package (questionary, importlib.resources)
├── ruby/                  # RubyGems gem (tty-prompt)
├── rust/                  # Cargo crate (dialoguer, include_dir — single binary)
├── php/                   # Packagist/Composer package (Symfony Console)
├── deno/                  # JSR package (TypeScript, @std/fs)
├── go/                    # Go module (charmbracelet/huh, go:embed — single binary)
├── demo/                  # Pre-generated demo (not in npm bundle)
├── scripts/
│   └── build-demo.js      # Regenerates demo/ with all options enabled
├── package.json
├── PLAN.md                # Full project plan and design decisions
└── README.md

Templates use {{VARIABLE_NAME}} placeholders that are replaced by the generator. Key variables:

1. Fork the repo
2. Create a feature branch: git checkout -b feat/my-awesome-feature
3. Make changes in templates/, src/, or bin/
4. Test locally: node bin/cli.js test-site --yes && open test-site/index.html
5. Rebuild the demo: npm run build:demo
6. Open a pull request

• New color themes
• Additional page types (music page, art gallery, blog page)
• More cursor effects (pixel trail, fire cursor)
• Web component versions of the decorative elements
• A --theme <name> CLI flag to skip the theme prompt

# Clone
git clone https://github.com/sugardaddyapp/geocities-boilerplate.git
cd geocities-boilerplate

# Install
npm install

# Test the CLI
node bin/cli.js my-test-site

# Rebuild demo
npm run build:demo

# Open demo
open demo/index.html

MIT © Jamey Baldwin

• Inspired by the preserved GeoCities archive and GifCities
• Color palette ideas from the original GeoCities neighborhood aesthetics
• Built with ❤️ and an unhealthy amount of nostalgia for 1996

Also checkout my other projects: Best Sugar Daddy Apps Best Sugar Daddy Apps 2026 Best Sugar Daddy Apps NPM Best Sugar Daddy Apps Socket

Best viewed in Netscape Navigator 4.0 at 800×600 resolution.