# Sahan Ranasingha — Full Stack Web Developer, Software Developer, WordPress Developer

> Official portfolio, software case studies, developer resume, WordPress plugins shop, and conversational AI assistant of Sahan Ranasingha, based in Akuressa, Sri Lanka.

## Entity Snapshot

- **Name**: Sahan Ranasingha
- **Roles**: Full Stack Web Developer, Software Developer, WordPress Developer
- **Location**: Akuressa, Sri Lanka
- **Availability**: Available for hire
- **Shipped Portfolio Projects**: 33+ documented projects (https://sahanranasingha.me/portfolio/)
- **Featured Open-Source Ecosystem**: Sri Lanka Holidays SDK (1,732 total downloads across 7 registries)
- **Core Technical Stack**: SQL, C#, Python, PHP, Java, Node.js, JavaScript (JS), TypeScript
- **Direct Email**: sahanranasingha1@gmail.com

## Primary Pages

- [Home](https://sahanranasingha.me/): Overview of track-record metrics, biography, engineering services, Sri Lanka Holidays SDK stats, latest case studies, client testimonials, and FAQ.
- [Portfolio](https://sahanranasingha.me/portfolio/): Full searchable/filterable directory of 33 shipped web applications, WordPress plugins, browser extensions, and developer tools.
- [Resume](https://sahanranasingha.me/resume/): Verified skills matrix, domain knowledge, education history, and engineering work history.
- [Shop](https://sahanranasingha.me/shop/): 8 commercial and open WordPress plugins, extensions, and developer add-ons.
- [Contact](https://sahanranasingha.me/contact/): Project inquiry form (WebMCP-enabled) and direct contact channels.
- [AI Assistant](https://sahanranasingha.me/assistant/): Real-time streaming portfolio assistant backed by project and resume knowledge (WebMCP-enabled).

## Engineering Services

- **Full-Stack Web Development**: Create modern, responsive web applications with robust backends using the MERN stack.
- **WordPress Development**: Build and customize WordPress websites tailored to your needs, from blogs to e-commerce.
- **Custom Software Development**: Design efficient and scalable desktop and web-based software solutions.
- **Technical Consulting & Support**: Provide expert advice and ongoing maintenance for your web and software projects.

## Featured Case Studies (12 of 33)

- [Sri Lanka Holidays SDK](https://sahanranasingha.me/portfolio/sri-lanka-holidays-sdk/): A lightweight, zero-dependency, multi-language open-source SDK providing official Sri Lanka Public, Bank, and Mercantile Holidays (including Full Moon Poya Days) for 2026 and 2027. Powered by a single canonical JSON dataset and published across 7 major language ecosystems (Node.js/TypeScript, PHP & Laravel, .NET/C#, Rust, Go, Python, and Flutter/Dart) to power HR, payroll, banking, and enterprise scheduling platforms.
- [Zellers AI Avurudu Avatar Platform](https://sahanranasingha.me/portfolio/zellers-ai-avurudu-avatar-platform/): Zellers AI Avurudu Avatar Platform is an end-to-end interactive digital campaign web application engineered for Zellers Chocolates to celebrate Sri Lanka's Sinhala & Tamil New Year. It pioneered Sri Lanka’s first AI Avurudu Kumara & Kumariya competition by transforming user portraits into high-fidelity traditional cultural avatars via a guided multi-step journey. Built with Next.js 16, React 19, Node.js, Express, and MongoDB, the system features a dual-channel OTP verification engine (SMS160 and WhatsApp API) with bcrypt hashing and rate limiting. Authenticated users complete an interactive cultural quiz matched to Zellers chocolate flavors, submit their portraits to an AI avatar generation pipeline, and participate in a tamper-resistant public voting gallery equipped with MongoDB aggregation leaderboards and full GA4/GTM/Clarity analytics telemetry.
- [Maliban Uththama Pranama](https://sahanranasingha.me/portfolio/maliban-uththama-pranama/): Maliban Uththama Pranama (මැලිබන් උත්තම ප්‍රණාම) is a full-stack, mobile-first wheelchair reservation and ground-dispatch management system developed for Maliban’s flagship CSR pilgrimage initiative during the sacred Poson Poya festival in Sri Lanka. Engineered to streamline mobility assistance for thousands of elderly and differently-abled pilgrims, the platform coordinates end-to-end logistics across high-density pilgrimage zones with zero paper overhead. Built with Next.js (App Router), TypeScript, and Tailwind CSS on the frontend and an Express/Firebase infrastructure on the backend, the system integrates SMS OTP authentication via the Text.lk API, localized bilingual support (Sinhala & English), and offline-capable PWA capabilities. Onsite ground agents utilize an integrated camera-based QR code scanner (`html5-qrcode`) for contactless validation—handling real-time dispatch, 45-minute session timeout tracking, and safe inventory return—while an administrative suite provides live fleet monitoring, slot quota allocation, and pilgrimage traffic analytics.
- [Mattermost Christmas Magic](https://sahanranasingha.me/portfolio/mattermost-christmas-magic/): Mattermost Christmas Magic is an interactive holiday plugin engineered for Mattermost platforms that transforms corporate workspaces with lightweight, festive animations and team engagement features. It introduces physics-aware snowfall, an original SVG Santa sleigh with synchronized festive audio, interactive gift drops with customizable joke or real reward cards, a walking snowman over the message input bar, and a rotating 3D Christmas tree featuring a live `/christmas` team wish engine. Designed for peak enterprise performance and zero distraction, the plugin operates without external network dependencies, respects WCAG reduced-motion preferences, and features zero-lag canvas rendering that throttles based on device specs. It provides granular administrator controls (date boundaries, flight intervals, content moderation for team wishes) alongside a seamless top-header toggle giving individual users full autonomy over animations and sound.
- [Subtitles Plus for Chrome Player](https://sahanranasingha.me/portfolio/subtitles-plus-for-chrome-player/): Subtitles Plus for Chrome Player is a commercial Chrome Manifest V3 extension engineered to upgrade Chrome's built-in video player with full external subtitle support, instant embedded Matroska (.MKV) track extraction, and subtitled Picture-in-Picture playback. Designed to eliminate the need for external media players when watching local or web videos in Chrome, the extension features a zero-memory binary EBML parser that reads embedded subtitle tracks from multi-gigabyte MKV files without loading video data into RAM. It automatically detects matching ".srt", ".vtt", and ".ass" subtitle files alongside local videos, provides live keyboard timing synchronization and custom styling, and renders burned-in subtitles inside a floating Picture-in-Picture window complete with a seekable progress bar.
- [Maliban Explore Island](https://sahanranasingha.me/portfolio/maliban-explore-island/): Maliban Explore Island is a high-concurrency, mobile-first event activation platform built for Maliban’s five-stall exhibition trail at the ProFood ProPack exhibition (BMICH, Sri Lanka). Designed to replace traditional "spin the wheel" activations, the platform guides visitors through a gamified digital map of the exhibition hall. By scanning secure physical QR codes at each of Maliban's five brand stalls, players unlock brand-specific mini-games, collect digital token pieces, and automatically enter live, hourly prize draws broadcasted on a giant screen.
- [TrustVault — an Enterprise-Grade Secure Password & Credential Manager](https://sahanranasingha.me/portfolio/trustvault/): An Enterprise-Grade Secure Password & Credential Manager built with modern web technologies and a zero-trust security architecture. Modern organizations need a secure way to store, share, and manage credentials without compromising security or collaboration. TrustVault was designed to solve that challenge by combining enterprise-grade cryptography, role-based access control, comprehensive audit logging, and a seamless browser experience.
- [Secure End-to-End Encrypted Terminal Chat System](https://sahanranasingha.me/portfolio/terminal-chat-e2e/): A real-time terminal-based chat application built with Node.js and Firebase, featuring end-to-end encrypted private and group messaging, friend management, and a modern CLI experience for developers who prefer secure communication directly from the terminal.
- [Sri Lanka Division Data npm Package](https://sahanranasingha.me/portfolio/sri-lanka-division-data-npm-package/): A reusable npm package that provides organized Sri Lanka location data for apps, forms, dashboards, validation, analytics, location-based software solutions, and administrative data integration.
- [CropConnect LK](https://sahanranasingha.me/portfolio/cropconnect-lk/): A full-stack web platform designed to connect farmers and buyers through seasonal demand planning, real-time crop matching, secure payments, and data-driven insights to reduce food waste and support sustainable agriculture in Sri Lanka.
- [QuizMaster AI](https://sahanranasingha.me/portfolio/quizmaster-ai/): A real-time interactive quiz platform with AI-powered quiz generation and live multiplayer gameplay, featuring instant feedback, scoring, and leaderboards for engaging experiences.
- [Cinematic Frame-by-Frame Scroll Animation](https://sahanranasingha.me/portfolio/cinematic-frame-by-frame-scroll-animation/): A smooth frame-by-frame scroll animation experiment inspired by modern web motion trends. The interaction creates a cinematic, 3D-like visual flow by syncing image frames with user scroll, resulting in a highly immersive browsing experience.

## Frequently Asked Questions

- **Who is Sahan Ranasingha and what does he specialize in?** Sahan Ranasingha is a Full Stack Web Developer, Software Developer, WordPress Developer based in Akuressa, Sri Lanka. He builds production websites, full-stack applications, custom WordPress plugins and themes, browser extensions, and open-source developer SDKs, with 33+ shipped projects published on https://sahanranasingha.me.
- **What software and web development services does Sahan Ranasingha offer?** Sahan Ranasingha provides Full-Stack Web Development, WordPress Development, Custom Software Development, Technical Consulting & Support. Each engagement covers architecture, custom implementation, performance optimization, security hardening, and ongoing maintenance via https://sahanranasingha.me/contact/.
- **What technologies and frameworks does Sahan Ranasingha work with?** Sahan Ranasingha works primarily with SQL, C#, Python, PHP, Java, Node.js, JavaScript (JS), TypeScript, along with modern headless WordPress architectures, REST/SSE APIs, Next.js, TypeScript, Tailwind CSS, GSAP motion engineering, and automated E2E workflows.
- **What is the Sri Lanka Holidays SDK?** Sri Lanka Holidays SDK is an open-source multi-language library created by Sahan Ranasingha that exposes structured Sri Lankan public, bank, and mercantile holiday datasets. Across tracked package registries including Node.js / TypeScript (1,237), PHP & Laravel (9), .NET / C# (166), Rust (10), it has reached 1,732 total downloads.
- **Where can I explore Sahan Ranasingha's shipped projects, WordPress plugins, and tools?** Browse full case studies at https://sahanranasingha.me/portfolio/ (33+ projects) and explore 8 downloadable WordPress plugins, Chrome extensions, and developer add-ons on https://sahanranasingha.me/shop/.
- **How can I contact or hire Sahan Ranasingha for a project?** You can submit a project brief on https://sahanranasingha.me/contact/, email sahanranasingha1@gmail.com, message directly via WhatsApp (https://wa.me/94742280570), or ask the interactive AI assistant at https://sahanranasingha.me/assistant/. Current status: Available for hire.

## Machine-Readable & Agentic Discovery

- [Full LLMs Documentation](https://sahanranasingha.me/llms-full.txt): Complete single-file Markdown dossier covering all 33 projects, resume history, services, testimonials, and shop catalog.
- [ARD Manifest](https://sahanranasingha.me/.well-known/ard.json): Agentic Resource Discovery (ARD) catalog manifest (`application/json`).
- [A2A Agent Card](https://sahanranasingha.me/.well-known/agent-card.json): Structured Agent2Agent capability card for Sahan's Portfolio Assistant.
- [XML Sitemap](https://sahanranasingha.me/sitemap.xml): Canonical URL index across static pages and all 33 portfolio case studies.
- [Robots Directives](https://sahanranasingha.me/robots.txt): Crawler rules explicitly welcoming search and AI retrieval agents.
- **Schema.org JSON-LD**: Every route emits connected `@id`-linked structured data (`Person`, `ProfessionalService`, `ProfilePage`, `Service`, `CreativeWork`, `SoftwareApplication`, `Product`, `Review`, `FAQPage`, `BreadcrumbList`).
- **WebMCP Support**: Interactive browser tools registered via `navigator.modelContext` (`get_developer_profile`, `list_portfolio_sections`, `navigate_portfolio`, `ask_portfolio_assistant`, `get_site_faqs`) plus declarative form annotations on `/contact/` and `/assistant/`.