Skip to content

Latest commit

Β 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ–‹οΈ Clatter

Where reminders arrive as gifts, not notifications.

A cozy typewriter calendar that turns your daily reminders into cinematic printed receipts. 🧾✨

Made with Love React TypeScript Vite

Ship date: July 10, 2026 🌸


🌸 The Story

Most calendar apps nag you. Ping. Buzz. Red dot. Anxiety.

Clatter is different.

Clatter is a cottagecore desktop calendar built around a vintage typewriter. When a reminder fires, a beautiful floral-bordered receipt scrolls out of the typewriter roller β€” letter by letter, with real typewriter sounds, ending with a satisfying ding.

It doesn't nag you. It gifts you a reminder. 🎁


✨ The Signature Moment

Set a reminder for 3:00 PM. Walk away. Live your life.

At 3:00 PM sharp, your typewriter comes alive:

  • πŸ–‹οΈ Paper scrolls up through the roller
  • ⌨️ Your note types out letter by letter (with real click sounds!)
  • πŸ”” A gentle ding announces it's ready
  • βœ‚οΈ You "tear off" the receipt when done

This isn't a notification. It's a tiny cinematic moment in your day.


🎨 Features

πŸ“… Cozy Calendar

  • Beautiful monthly view with month navigation
  • Today's date highlighted in pink
  • Click any date to add notes, stamps, or reminders

πŸ“ Cozy Notes

  • Write anything on any date
  • Handwritten font for that diary feel
  • Edit, update, or delete anytime

🎨 12 Custom Stamps

Tag your dates with mood/type markers:

πŸŽ‚ Birthday πŸ’• Love ⭐ Special β˜• Coffee 🌸 Self-care 🐾 Pet
πŸ’Ό Work πŸ“– Study ⏰ Deadline βž• Health 🎡 Event 🎁 Gift

⏰ Time-Based Reminders

  • Set an optional time when creating a note
  • Auto-triggers the receipt animation at that time
  • No permission popups, no browser nags β€” just pure magic

🧾 The Receipt Animation (The Star!)

  • Floral cream paper with torn edges
  • Real typewriter letter-by-letter effect
  • Custom paw print branding
  • Cinematic scroll-out from the typewriter roller

🎡 Real Typewriter Sounds

  • Click sound per letter (adjustable volume)
  • Classic ding + paper roll on completion
  • Satisfying paper tear on close
  • Toggle sounds on/off (preference saved!)

πŸ’Ύ Everything Persists

  • All notes, stamps, reminders saved locally
  • Sound preferences remembered
  • Zero backend, zero accounts, 100% private

πŸ–ΌοΈ Design Philosophy

Cottagecore Kawaii meets Vintage Typewriter

Clatter is what you'd get if a Studio Ghibli movie designed a calendar app. Warm, romantic, playful, tactile.

🎨 Color Palette

  • πŸ’— Rose Pink #C73E5F β€” the main character
  • 🍦 Cream Paper #F5E6C8 β€” soft warmth
  • 🌿 Teal Accent #4A9B8E β€” playful pop
  • ❀️ Poppy Red #D63838 β€” vintage floral vibes
  • πŸ–€ Deep Ink #4A1F2E β€” grounded elegance

πŸ–‹οΈ Typography

  • Special Elite β€” authentic typewriter feel
  • Courier Prime β€” monospaced elegance
  • Caveat β€” handwritten softness for notes

πŸ› οΈ Tech Stack

  • βš›οΈ React 18 + TypeScript β€” modern, type-safe
  • ⚑ Vite β€” lightning-fast dev experience
  • 🎬 Framer Motion β€” buttery smooth animations
  • πŸ“… date-fns β€” clean date handling
  • 🎨 Custom CSS β€” hand-crafted cottagecore design system
  • πŸ’Ύ LocalStorage β€” zero-backend persistence

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • npm

Installation

Clone the repository:

  • git clone https://github.com/bistighosh16/clatter.git
  • cd clatter

Install dependencies:

  • npm install

Start the dev server:

  • npm run dev

Open http://localhost:5173 in your browser and start clattering! πŸ–‹οΈβœ¨


πŸ’• How to Use

  1. Click any date on the calendar
  2. Write a cozy note in the modal
  3. Pick a stamp to visually tag the day (optional)
  4. Set a reminder time (optional!)
  5. Save and watch a beautiful receipt print immediately
  6. If you set a reminder β€” walk away and let the magic surprise you at that time!

🎨 Custom Assets

All visual assets are custom-generated for Clatter's unique aesthetic:

  • πŸ–‹οΈ Typewriter illustration β€” Custom-prompted cottagecore design
  • 🎨 12 rubber stamps β€” ink texture style
  • 🧾 Receipt paper template β€” vintage floral bordered design
  • 🎡 Sound effects β€” royalty-free from Pixabay

🌟 What Makes Clatter Different

Traditional Calendar Clatter
Cold digital notifications Cinematic printed receipts
Same UI everywhere Cottagecore art direction
Emojis for events Hand-drawn custom stamps
Requires accounts 100% local + private
Functional Emotional

πŸš€ Roadmap

  • πŸ“… Weekly / daily view
  • 🎨 Multiple typewriter color themes
  • πŸŒ… Morning digest receipt on startup
  • πŸ“Š Streaks & stats
  • πŸ–₯️ Desktop app via Tauri
  • πŸ“Έ Export receipts as shareable images
  • 🌐 Optional cloud sync
  • πŸ” Recurring reminders

πŸ’Œ A Note From the Maker

Clatter started as a simple question: "What if reminders felt like little gifts instead of interruptions?"

Every design decision β€” from the flowers on the typewriter to the paw print on the paper to the letter-by-letter typing β€” was made with intention. This isn't just an app. It's a small piece of everyday magic.

I hope it makes your days a little cozier. 🌸


Made with πŸ’•πŸΎ by Vivi

Building tiny cinematic experiences, one commit at a time. ✨

⭐ Star this repo if Clatter made you smile!

About

πŸ–‹οΈ A cozy cottagecore typewriter calendar where reminders arrive as printed receipts, not notifications 🧾🌸

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages