Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Nawoth-Th/Oil-Lamp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

16 Commits

Repository files navigation

πŸͺ” Pol Thel Pahana β€” Online Awrudu Uthsawaya 2026

An interactive web application that simulates the traditional Sri Lankan Pol Thel Pahana Paththuwa (coconut oil lamp lighting ceremony) for an online Awrudu Uthsawaya celebration.


✨ Features

  • Interactive Oil Lamp β€” A real brass lamp image with 7 precise wick points, each individually clickable
  • Flame Animation β€” Smooth flicker animation with glow effect when a wick is lit
  • Celebration Overlay β€” Confetti burst and Sinhala New Year message when all 7 wicks are lit
  • Live Sync β€” Pusher-based real-time state sharing compatible with serverless hosting (Vercel)
  • State Persistence β€” Upstash Redis ensures lit wicks are remembered across sessions and restarts
  • Background Music β€” Toggle traditional Awrudu audio
  • Progress Bar β€” Visual tracker showing how many wicks have been lit
  • Countdown Timer β€” Live countdown to the Sinhala New Year moment (April 13, 2026 at 6:17 AM)
  • Responsive Design β€” Works on desktop and mobile

πŸ›  Tech Stack

Layer Technology
Framework Next.js 15 (App Router)
Styling Tailwind CSS v4 + Vanilla CSS
Animations Framer Motion
Real-time Events Pusher Channels
Persistence Upstash Redis
Language TypeScript
Package Manager pnpm

πŸ“ Project Structure

×ば぀500px) β”‚ β”œβ”€β”€ header-01.png # Sinhala title header image β”‚ β”œβ”€β”€ header-02.png # Awrudu year header image β”‚ └── ... # Audio & other assets">
pahana-app/
β”œβ”€β”€ app/
β”‚ β”œβ”€β”€ api/lamp/route.ts # Serverless API (Redis sync + Pusher trigger)
β”‚ β”œβ”€β”€ globals.css # Design tokens, animations, base styles
β”‚ β”œβ”€β”€ layout.tsx # Root layout & metadata
β”‚ └── page.tsx # Main page β€” lamp, countdown, progress, controls
β”œβ”€β”€ components/
β”‚ β”œβ”€β”€ OilLamp.tsx # Lamp image + wick overlay positioning
β”‚ β”œβ”€β”€ Wick.tsx # Individual wick button + flame host
β”‚ β”œβ”€β”€ Flame.tsx # Animated SVG flame component
β”‚ β”œβ”€β”€ Celebration.tsx # All-lit overlay with confetti
β”‚ β”œβ”€β”€ ProgressBar.tsx # Wick lit progress indicator
β”‚ └── AudioToggle.tsx # Background music on/off toggle
β”œβ”€β”€ hooks/
β”‚ └── useLampState.ts # Pusher real-time hook (syncs with API)
β”œβ”€β”€ public/
β”‚ β”œβ”€β”€ lamp.png # Brass oil lamp source image (×ば぀500px)
β”‚ β”œβ”€β”€ header-01.png # Sinhala title header image
β”‚ β”œβ”€β”€ header-02.png # Awrudu year header image
β”‚ └── ... # Audio & other assets

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • pnpm
  • Pusher Account (Free tier)
  • Upstash Redis Database (Free tier)

Environment Setup

Create a .env.local file in the pahana-app/ directory and add your keys:

# Pusher
NEXT_PUBLIC_PUSHER_APP_KEY="your-key"
NEXT_PUBLIC_PUSHER_CLUSTER="your-cluster"
PUSHER_APP_ID="your-id"
PUSHER_SECRET="your-secret"
# Upstash Redis
UPSTASH_REDIS_REST_URL="your-url"
UPSTASH_REDIS_REST_TOKEN="your-token"

Install & Run

# Install dependencies
pnpm install
# Start the development server
pnpm dev

Open http://localhost:3000 in your browser.


🎨 Design

  • Palette β€” Deep dark brown background (#0f0500) with gold (#f5c842), amber, and orange accents
  • Typography β€” Cinzel (headings) + Noto Serif Sinhala (Sinhala script)
  • Wick coordinates β€” Measured precisely from the ×ば぀500px lamp image and mapped as percentages onto the container for pixel-perfect flame placement

🌺 Ceremony

Light all 7 wicks to complete the ceremony and receive the New Year blessing:

ΰ·ƒΰ·”ΰΆΆ ΰΆ…ΰΆ½ΰ·”ΰΆ­ΰ·Š ΰΆ…ΰ·€ΰ·”ΰΆ»ΰ·”ΰΆ―ΰ·ŠΰΆ―ΰΆšΰ·Š ΰ·€ΰ·šΰ·€ΰ· ! (Wishing you a Happy New Year!)

About

An interactive web application that simulates the traditional Sri Lankan Pol Thel Pahana Paththuwa (coconut oil lamp lighting ceremony) for an online Awrudu Uthsawaya celebration.

Resources

License

Stars

Watchers

Forks

Sponsor this project

Contributors

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /