# Wishiva

> Don't just send a wish. Create an experience. Turn your photos, memories and words into an interactive digital surprise someone will remember.

Wishiva is an interactive digital keepsakes and surprise greeting card platform built on Next.js and deployed on Netlify. It provides tactile web experiences (wax seal envelope reveals, scratch-off cards, interactive candle blowout cakes, gift box unwraps, and printable QR gift tags) that run smoothly in mobile browsers with zero app installation.

- Base URL: https://wishiva.netlify.app
- Hosting Provider: Netlify
- Full Context: https://wishiva.netlify.app/llms-full.txt
- Sitemap: https://wishiva.netlify.app/sitemap.xml
- OpenAPI 3.1 (JSON): https://wishiva.netlify.app/api/openapi.json
- OpenAPI 3.1 (YAML): https://wishiva.netlify.app/.well-known/openapi.yaml
- Model Context Protocol (MCP): https://wishiva.netlify.app/.well-known/mcp.json
- Developer Documentation: https://wishiva.netlify.app/docs

## Core Experiences & Reveal Styles
- Wax Seal Envelopes: Breakable 3D wax seal with realistic tear physics and acoustic chime.
- Golden Scratch Cards: Coin-scratching reveal of hidden messages, polaroid photos, and coupon gifts.
- Interactive Birthday Cake: Virtual candles with tap/blowout detection and confetti fanfare.
- Gift Box Unwrap: Ribboned 3D box unboxing with ambient background soundtrack.
- Printable QR Gift Tag Cards: High-resolution printable cards with QR codes linking to the digital experience.
- Secret Passcode Protection: 4-digit PIN lock with custom clue.

## Key Pages & Documentation
- [Homepage](https://wishiva.netlify.app/): Main landing page with interactive preview and feature highlights.
- [Template Catalog](https://wishiva.netlify.app/templates): Pre-made curated designs for Birthdays, Anniversaries, Besties, Graduations, and Gratitude.
- [Surprise Studio](https://wishiva.netlify.app/create): Interactive builder to design and personalize a digital surprise.
- [Developer Hub](https://wishiva.netlify.app/docs): API reference, OpenAPI spec, MCP tools, and Netlify deployment instructions.
- [Pricing Matrix](https://wishiva.netlify.app/#pricing): One-time keepsake plans (Free ₹0, Premium ₹49, Ultimate ₹99).

## Developer APIs & Endpoints
- `GET /api/templates`: List curated templates with filtering by occasion.
- `GET /api/health`: Platform health check, runtime status, and version metadata.
- `GET /api/openapi.json`: OpenAPI 3.1.0 schema in JSON format.
- `GET /api/mcp`: Model Context Protocol tool catalog for AI agents.
- `POST /api/feedback`: Submit user or automated audit feedback.

## Content Negotiation (acceptmarkdown.com)
Wishiva supports Markdown content negotiation. AI agents sending `Accept: text/markdown` or `Accept: text/x-markdown` receive structured markdown responses with `Vary: Accept, Accept-Encoding`.