Skip to content

kako-jun/nostalgic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

520 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Nostalgic

ๆ—ฅๆœฌ่ชž็‰ˆใฏใ“ใกใ‚‰

Visitors Welcome

A comprehensive nostalgic web tools platform that brings back the 90s internet culture with modern technology. Five essential services that used to be on every personal homepage: Counter, Like, Ranking, BBS, and Yokoso.

โœจ Services

๐Ÿ“Š Counter Service

  • Multiple time periods: Total, today, yesterday, weekly, monthly statistics
  • Daily duplicate prevention (resets at midnight)
  • 3 nostalgic display styles: Light, Dark, Kawaii
  • Web Components for easy embedding

๐Ÿ’– Like Service

  • Toggle-based like/unlike functionality
  • User state tracking (IP + UserAgent)
  • Daily limit: One like per day per user (resets at midnight)
  • Instant feedback with current state

๐Ÿ† Ranking Service

  • Score leaderboards with automatic sorting
  • Score management (submit, update, remove)
  • Configurable entry limits
  • Real-time ranking updates with formatted display scores

๐Ÿ’ฌ BBS Service

  • Message board with fixed height display (400px)
  • Pagination that starts at latest messages
  • Customizable dropdown selections
  • Author-based message editing
  • Icon selection for posts

๐Ÿฑ Yokoso (Lucky Cat) Service

  • Lucky cat widget that speaks your message
  • Update just one part of your page independently
  • Perfect for announcements on static pages
  • A modern alternative to X (Twitter) embeds
  • SVG images for GitHub README embedding

โœจ Common Features

  • ๐Ÿšซ No registration required: Just provide a URL and secret token
  • ๐Ÿ”’ Secure ownership: SHA256 hashed tokens, public ID system
  • ๐ŸŒ Easy integration: RESTful APIs with action parameters
  • โšก Fast & reliable: Built on Cloudflare Workers + D1
  • ๐Ÿ”— GET-first APIs: Every action works as a plain GET URL โ€” run it straight from the address bar, like the old web

๐Ÿš€ Quick Start

Counter Service

  1. Create your counter (GET):
https://api.nostalgic.llll-ll.com/visit?action=create&url=https://yoursite.com&token=your-secret-token
  1. Display counter (GET, using the public ID returned by create):
https://api.nostalgic.llll-ll.com/visit?action=get&id=yoursite-a7b9c3d4
  1. Embed in your site:
<script src="https://nostalgic.llll-ll.com/components/visit.js"></script>
<nostalgic-counter id="yoursite-a7b9c3d4" type="total" theme="dark"></nostalgic-counter>

Like Service

  1. Create like button (GET):
https://api.nostalgic.llll-ll.com/like?action=create&url=https://yoursite.com&token=your-secret-token
  1. Toggle like (GET, by public ID):
https://api.nostalgic.llll-ll.com/like?action=toggle&id=yoursite-a7b9c3d4

Ranking Service

  1. Create ranking (GET):
https://api.nostalgic.llll-ll.com/ranking?action=create&url=https://yoursite.com&token=your-secret-token&maxEntries=100
  1. Submit a score (GET, by public ID):
https://api.nostalgic.llll-ll.com/ranking?action=submit&id=yoursite-a7b9c3d4&name=Alice&score=1000
  1. Get ranking (GET):
https://api.nostalgic.llll-ll.com/ranking?action=get&id=yoursite-a7b9c3d4

BBS Service

  1. Create BBS (GET):
https://api.nostalgic.llll-ll.com/bbs?action=create&url=https://yoursite.com&token=your-secret-token&maxMessages=100
  1. Post messages (GET, by public ID โ€” just like the old days):
https://api.nostalgic.llll-ll.com/bbs?action=post&id=yoursite-a7b9c3d4&author=User&message=Hello!

Yokoso Service

  1. Create Yokoso (GET):
https://api.nostalgic.llll-ll.com/yokoso?action=create&url=https://yoursite.com&token=your-secret-token&message=Welcome!
  1. Embed in your site:
<script src="https://nostalgic.llll-ll.com/components/yokoso.js"></script>
<nostalgic-yokoso id="yoursite-a7b9c3d4"></nostalgic-yokoso>

๐ŸŽฎ Try the Demos

Visit our interactive demo pages:

๐Ÿ”ง API Architecture

All services follow a unified action-based API pattern. Every action accepts GET with query parameters โ€” you can run any of them straight from the browser address bar, like the old web. The base URL is https://api.nostalgic.llll-ll.com:

GET /{service}?action=get&id={public-id}
GET /{service}?action={owner-action}&url={your-site}&token={your-token}

POST with a JSON body is also supported (body values take precedence over query parameters; action is always read from the query string). The batch actions (batchGet, batchCreate, batchLookup) are POST-only because they carry array payloads.

๐ŸŒ Nostalgic Yet Modern

Inspired by 1990s web culture, but with modern best practices:

  1. Simple APIs: Action-based routing keeps things straightforward
  2. URL-based everything: Create, update, and display are all plain GET links you can share
  3. Easy embedding: Web Components for drop-in integration
  4. No registration: Just a URL and a secret token

Available Actions by Service:

Service Actions Description
Counter create, increment, get, update, delete Traditional visitor counter
Like create, toggle, get, update, delete Like/unlike button
Ranking create, submit, update, remove, clear, get, delete Score leaderboard
BBS create, post, update, remove, clear, get, delete Message board
Yokoso create, update, get, delete Lucky cat widget

๐Ÿ“– Documentation

API Documentation

Service-Specific Guides

Customization

Live Demo

๐Ÿ›ก๏ธ Security & Privacy

What data we collect and store:

  • Service URLs (identifier only, not used for tracking)
  • Secret tokens (hashed with SHA256)
  • User identification (IP + UserAgent hash, for duplicate prevention and authorship)
  • Service data (counts, likes, scores, messages - no personal data)

What we DON'T collect:

  • No cookies, no tracking pixels
  • No personal information (name, email, etc.)
  • No browsing history or referrer data
  • IP addresses are hashed for privacy

Security measures:

  • Your secret tokens are hashed and stored securely
  • Public IDs can only display/interact, not modify
  • User identification via temporary IP+UserAgent hash
  • Author verification for message editing/removal

๐Ÿ“œ License

MIT License - feel free to use, modify, and distribute.

๐ŸŒŸ Contributing

Issues and pull requests are welcome! Let's bring back the nostalgic web together.


Made with โค๏ธ for the nostalgic web

About

Self-hostable 90s-style web widgets (counter, like, ranking, BBS, lucky cat) on Cloudflare Workers and D1

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors