✦ AuraTime

Good Time / Bad Time Checker

A lightweight, cross-platform utility that instantly tells you whether the current time falls within traditionally inauspicious Vedic time periods — Rahu Kalam, Yamagandam, or Gulika Kalam.

Works as both an interactive Terminal CLI and an accessible, installable Progressive Web App (PWA).

---

✨ Features

• ⚡ Instant results — Accurate Vedic auspicious status computed in < 2ms.
• 🎨 Multi-Theme Cycling Engine — Seamlessly cycle through 5 tailored themes:
  • 🌌 Cosmic Midnight (Default deep obsidian & indigo glow)
  • ☀️ Pristine Dawn (Clean, high-contrast light mode)
  • 🌅 Solar Twilight (Vedic amber, warm saffron, and terracotta dusk)
  • 🌿 Zen Forest (Deep pine slate with radiant emerald accents)
  • 🔮 Mystic Cyber (Synthwave abyss with electric cyan & magenta)
• 🖼️ Modern Vector Favicons & PWA Icons — Handcrafted SVG vector favicon, multi-resolution .ico, Apple touch icon, and high-DPI PWA icons organized in assets/.
• 🚀 Vercel Ready — Built-in vercel.json with clean URLs, PWA caching headers, and automatic root routing.
• ♿ Full Accessibility — Keyboard navigable schedule items (Enter / Space), non-intrusive focus rings, screen reader labels, and accessible modal dialogs with proper inert isolation.
• 📱 PWA with Offline Support — Installable on mobile & desktop, functioning 100% offline via Service Worker.
• 🖥️ Cross-Platform — Windows (.bat), Linux (.sh), and macOS (.sh) one-click launchers.
• 🕐 24-Hour Time Format — Unambiguous live digital clock.
• 📖 Educational Insights — Interactive explanation cards for every Vedic planetary period.

---

Quick Start

CLI (Terminal)

Windows:

auratime.bat

Linux / macOS:

chmod +x auratime.sh
./auratime.sh

Via npm:

npm start          # Interactive live dashboard
npm run check      # One-shot check (prints status and exits)

PWA (Browser)

Windows:

auratime_web.bat

Linux / macOS:

chmod +x auratime_web.sh
./auratime_web.sh

Via npm manually:

npm run serve

Then visit http://localhost:3003/ (automatically routes to the PWA interface).

Deploy to Vercel

AuraTime is pre-configured with vercel.json. Simply push this repository to GitHub and import it on Vercel:

• Framework Preset: Other / Static
• Root Directory: ./
• Zero build configuration required!

---

Controls

CLI Controls

Key	Action
R	View Rahu Kalam explanation
Y	View Yamagandam explanation
G	View Gulika Kalam explanation
S	Return to main schedule view
↑ / ↓	Navigate between explanations
Q	Quit

Web & PWA Controls

Action	Control
Cycle Theme	Click the theme button or press Enter/Space when focused
Inspect Period	Click or press Enter on any schedule card to open details
Close Dialog	Press Escape, click the × button, or click outside the modal

---

Time Periods

Period	Meaning	Vedic Guidance
Rahu Kalam	Ruled by the shadow planet Rahu.	Traditionally avoided for starting new ventures or travel.
Yamagandam	Governed by Yama, deity of death & justice.	Avoid ceremonies and long-term commitments.
Gulika Kalam	Linked to Saturn's sub-planet Gulika.	Repeated efforts required; ideal for ongoing or repetitive tasks.

---

⚙️ Calculation Logic & Trade-offs

AuraTime uses a standard 06:00 sunrise / 18:00 sunset baseline rather than a live Ephemeris. This is a deliberate architectural decision to ensure:

• ⚡ Instant Loading — No GPS geocoding lag or external network roundtrips.
• 🔒 Absolute Privacy — No location permissions requested, tracked, or stored.
• ✈️ Offline Native — Works anywhere on Earth without connectivity.
• 📦 Zero Runtime Dependencies — Pure standard web technologies that stay fast forever.

For temple rituals requiring exact astronomical degrees, we recommend consulting a local Ephemeris Panchang.

---

Project Structure

good-time-check/
├── assets/                     # Organized brand and icon assets
│   ├── favicon.svg             # Scalable vector favicon
│   ├── favicon.ico             # Multi-size Windows / browser icon
│   ├── favicon-16x16.png       # 16px PNG favicon
│   ├── favicon-32x32.png       # 32px PNG favicon
│   ├── apple-touch-icon.png    # 180px iOS home screen icon
│   ├── icon-192.png            # 192px Android / PWA icon
│   ├── icon-512.png            # 512px high-res splash icon
│   ├── release_v1_0_0.png      # v1.0.0 promotional banner
│   └── release_v1_0_2.png      # v1.0.2 promotional banner
├── core/
│   ├── time_tables.js          # Shared Vedic schedule tables
│   ├── time_calculator.js      # Core status computation engine
│   └── time_calculator.test.js # Vitest automated test suite
├── cli/
│   └── interface.js            # Terminal interface with ANSI colors
├── pwa/
│   ├── index.html              # PWA app shell
│   ├── style.css               # Multi-theme glassmorphism design
│   ├── app.js                  # PWA application & cycling theme logic
│   ├── service-worker.js       # Resilient offline cache manager
│   └── manifest.json           # Web App Manifest
├── scripts/
│   ├── generate_icons.js       # Standalone zero-dependency icon generator
│   └── sync_to_web.js          # Synchronizes updates with good-time-web
├── index.html                  # Root redirect fallback
├── vercel.json                 # Vercel deployment and caching config
├── auratime.bat                # Windows CLI launcher
├── auratime.sh                 # Linux/macOS CLI launcher
├── auratime_web.bat            # Windows Web launcher
├── auratime_web.sh            # Linux/macOS Web launcher
├── package.json
└── README.md

---

Documentation

• Ideology & Knowledge — Detailed guide on Rahu, Yama, and Gulika.
• Code Documentation — Dive into engine architecture and theme design tokens.
• Design Philosophy — The rationale behind AuraTime's minimal, privacy-first UX.
• Release Notes — Version changelog and upgrade highlights.
• Contributing — Contributor guidelines and workflow.

---

Requirements

• Node.js (v20 or later LTS) — For the CLI and icon generation.
• Modern Browser — Chrome, Safari, Firefox, Edge for the PWA.

---

License & Copyright

Copyright (C) 2026 Krishna Kanth B

This project is licensed under the GPL v3 License - see the LICENSE file for details.