Skip to content

Repository files navigation

⚡ Zencus — Where Zen Meets Focus

“Your mind is for having ideas, not holding them.”

Live Demo React 19 Vite Framer Motion PWA Ready License: MIT PRs Welcome

Zencus is a gamified, hyper-aesthetic productivity suite fusing Brain Dump organization, Pomodoro flow states, Fullscreen Zen Mode with mouse-idle auto-hide, WebGL Fog Sphere ray-marching shaders, a Living Animal Universe with daily trending topics, and cognitive neuroscience offloading.



🌟 Highlights at a Glance

       ⚡ ZENCUS PRODUCTIVITY ECOSYSTEM
 ├── ⏱️ Flow Engine     -> Pomodoro dials, liquid tanks, mini-pill timer, full-screen Zen mode
 ├── 🔮 WebGL FogSphere -> Volumetric ray-marching shader with mode-adaptive atmospheric auroras
 ├── 🐾 Animal Universe -> 20 collision-free chit-chat clusters with automatic daily trending topics
 ├── 🧠 Brain Dump Hub  -> Hierarchical folders, Whiteboard sketchpad, 4-digit PIN lock, dynamic tables
 ├── 🎨 18 Theme Modes  -> 6 Solid Dual Palettes + 12 Experiential Themes (8-Bit, Matcha, Tokyo, etc.)
 ├── 🎧 Ambient Audio   -> Procedural Web Audio binaural beats, rain synth, chiptune coin rewards
 └── 🧠 Cognitive RAM   -> Real-time working memory offloading motivation grounded in neuroscience

🧠 1. Brain Dump Section (Advanced Note-Taking Suite)

  • 📁 Hierarchical Folders: All Notes, Quick Notes, Work, Personal, Ideas & Drafts, Archive, and Recently Deleted (Trash Bin) + Custom folder creation.
  • 🎨 Whiteboard Drawing Canvas: Embedded drawing pad with pen, highlighter, eraser, brush thickness sliders, and instant note embedding.
  • 🔒 4-Digit Biometric PIN Lock: Password-protect sensitive notes with blurred previews and animated numeric security keypad.
  • 📊 Dynamic Tables & Rich Markdown: Add interactive data tables, checkboxes, quotes, code snippets, and headers.
  • 🏷️ Smart #Hashtags & Live Analytics: Real-time word count, character count, reading time calculator, and hashtag pills.
  • 📥 Export to Markdown: 1-click export of any note into portable .md format.

🎨 2. 12 Experiential Theme Modes

Switch seamlessly between 12 sensory themes tailored for different mood states:

Theme Aesthetic Palette Psychological Focus State
🖤 Obsidian Zen Deep monochrome & soft spotlight cards Clean, distraction-free clarity
👾 8-Bit Retro Arcade Authentic pixel typography, CRT scanlines & chiptunes Nostalgia, inner-child playfulness
🌳 Ghibli Matcha Forest Deep pine #0d1f12, sage & matcha greens Calming biophilic attention restoration
☕ Cozy Lo-Fi Coffee Warm espresso #180d08, caramel & latte cream Relaxed study lounge vibe
🏎️ Midnight Tokyo Drift Deep purple night #0f001a, hot neon pink #ff1361 High-energy flow state & gamer adrenaline
🌊 Deep Ocean Abyss Trench abyss #020617, electric seafoam #00f5d4 Serene immersion & deep focus
⚡ Solar Saiyan Energy Charcoal dark #0a0802, golden aura #facc15 Intense milestone sprints & willpower
📟 Matrix Terminal Code Void black #020803 & phosphor terminal green #00ff66 Terminal coding & deep work
🌆 Cyberpunk Synthwave Neon Magenta #ff007f & electric laser cyan gridlines 80s Outrun synthwave vibe
💀 Haunted Horror Blood crimson obsidian, ghost mascot, storm audio High-alertness thrill
🚀 Tactical Sci-Fi HUD NASA / Iron Man telemetry brackets & sonar pings Diagnostic mission control
☀️ Crisp Light High-contrast daylight clarity Daylight focus

🐾 3. Focus Pet Wardrobe (7 Interactive Mascots)

Adopt and switch your productivity companion at any time:

  • 🦖 Neo the Pixel Dino: Loyal runner who jogs along the timer tank rim and celebrates streaks.
  • 🐱 Luna the Pixel Cat: Swishes her tail, purrs when petted, and keeps your mind cozy.
  • 🦉 Archimedes the Wise Owl: Wearing mini glasses, bobs head, and drops cognitive neuroscience facts.
  • 🐉 Pyro the Baby Dragon: Flaps wings and breathes golden embers when you finish tasks.
  • 🚀 Cosmo the Space Cadet: Floats in zero-gravity orbit with a reflective galaxy helmet.
  • 🤖 Byte the Cyber Mech: Holographic scanner bot optimizing your neural bandwidth.
  • 👻 Spooky the Friendly Ghost: Floating phantom who roasts procrastination and haunts overdue tasks.

🧠 4. Cognitive Science & Memory Offloading

"Your brain is a processor, not a hard drive. It is built for having ideas, not holding them."

Holding unwritten tasks consumes up to 40% of working memory bandwidth (Miller's Law & Sweller's Cognitive Load Theory). FOCUS actively prompts and reminds you to offload fleeting sparks onto notes and task queues, freeing your subconscious for creative problem solving.


🛠️ Tech Stack & Architecture

  • Core: React 19, Vite 6, Modern ES Modules
  • Animations: Framer Motion 12, Canvas Confetti
  • Component Design System: Curated React Bits (ShinyText, BlurText, SpotlightCard, DecryptedText, MagnetButton, ParticlesBackground, ClickSpark)
  • Audio Engine: Native Web Audio API procedural synthesis (binaural beats, white noise, chiptune coins, laser zaps)
  • Deployment: Automated GitHub Actions CI/CD to GitHub Pages

🚀 Quickstart & Local Setup

# 1. Clone the repository
git clone https://github.com/Deeprockz22/Zencus.git

# 2. Navigate to project directory
cd Zencus

# 3. Install dependencies
npm install

# 4. Launch development server
npm run dev

Open http://localhost:5173 in your browser!

📦 Build & Deploy to GitHub Pages:

npm run deploy

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated!


📄 License

MIT License © 2026 Jakk Manideep (Deeprockz22)

About

Zencus — Where Zen meets Focus. Minimalist Pomodoro flow suite with a Zen Fullscreen mode, WebGL Fog Sphere, Living Animal Universe with daily trends, and brain dump notes.

Topics

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages