# Jyserai — Extended documentation for AI agents

> Jyserai is a French-language RSVP visual generator for Francophone West Africa. Organizers create "J'y serai" (I'll be there) campaigns; their audience drops a photo into a branded frame and instantly downloads a personalized share-ready image.

## What Jyserai is (and is not)

Jyserai **is** a campaign-based user-generated content platform. The unit of value is the **campaign**: a single branded frame (image or short video) with a transparent photo zone, exposed at a public URL.

Jyserai is **not** a ticketing platform, a generic event marketplace, or a design tool. Ticketing and QR scanning are intentionally hidden ("Bientôt disponible").

## Full feature list

### For organizers (campaign creators)
- Free campaign creation with a branded frame upload (image or MP4 video, H.264/AAC for WhatsApp compatibility)
- Inline photo-zone editor to mark the transparent region where the participant photo will appear
- Custom slug (e.g. `jyserai.site/jour-de-lan-2026`)
- Public campaign page with one-tap upload + generation + download flow
- Real-time social wall showing recent generated visuals
- Campaign moderation queue (super admin approval before public listing)
- Watermark removal request (1000 FCFA via iKeepay) — only the creator can trigger this
- Premium subscription (monthly / yearly) for unlimited frames
- Email notifications on campaign approval, watermark removal, and download milestones (10, 50, 100, 500, 1k, 5k, 10k)
- Granular analytics in the Super Admin dashboard (live presence, click funnels, page-level events)

### For visitors (participants)
- No account required to generate a visual on a public campaign URL
- Image upload with `aspect-free` proportions (no forced cropping)
- Client-side rendering using `destination-over` canvas composite to preserve frame transparency
- 1% D-pad fine-tune for photo position
- Confetti + iOS Web Share API on download
- Direct WhatsApp share with optimized OG tags

### Payments
- iKeepay iframe checkout (Orange Money, Moov Money, Wave, MTN MoMo, MasterCard, Visa)
- USSD fallback for low-bandwidth areas
- All amounts in XOF (CFA franc)
- Watermark removal: 1000 FCFA per visual
- Subscription: pricing visible at https://jyserai.site/tarifs

### AI capabilities
- Frame generation via Lovable AI Gateway (Gemini 2.5), Gemini direct, and OpenAI DALL-E 3
- AI assistant for campaign creation (Super Admin only, currently)

## FAQ

**Who is Jyserai for?**
Event organizers and creators in Francophone West Africa who want their audience to share branded "I'll be there" visuals before an event.

**Is it free?**
Yes — creating campaigns is free and visitors can download visuals for free with a small 1000 FCFA watermark. Only watermark removal and premium subscriptions cost money.

**What payment methods are supported?**
Mobile money (Orange Money, Moov Money, Wave, MTN MoMo) via iKeepay, plus card payments and a USSD fallback. All in XOF.

**Can I use Jyserai outside Francophone West Africa?**
The product is in French and pricing is in XOF, but the public URLs work globally and any visitor can generate a visual.

**How do you ensure visuals look good on WhatsApp?**
Videos are encoded MP4 H.264/AAC and uploaded to Cloudinary; share links use a double-URL system so OG tags resolve correctly while users are still routed to the generator.

**Is there a public API?**
Yes — read-only endpoints for fetching public campaigns and submitting download events. See the OpenAPI spec at `/openapi.json`.

**Do you have an MCP server?**
Yes, see `/mcp.json`. It exposes `search_campaigns`, `get_campaign`, and `list_featured_campaigns` tools.

**Can AI assistants summarize my campaigns?**
All public-listed (approved & free or watermark-active) campaigns expose Open Graph and JSON-LD metadata. AI crawlers are explicitly allowed in `/robots.txt`.

## API reference (read-only)

All endpoints are unauthenticated and return JSON. Base URL: `https://qucmrhuelkzmykqzscyw.supabase.co/rest/v1`. Send the public anon key as `apikey` and `Authorization: Bearer <anon-key>`. The anon key is published in `/.well-known/agent.json`.

### `GET /campaigns?status=eq.approved&select=id,title,slug,description,image_url,downloads,created_at`
Returns the list of approved public campaigns.

### `GET /campaigns?slug=eq.<slug>&select=*`
Returns a single campaign by slug.

### `POST /functions/v1/share-og`
Returns OG metadata for a given campaign URL (used for WhatsApp/Twitter previews).

A simplified, agent-friendly OpenAPI 3.1 description is published at `/openapi.json`.

## Routes index

| Path | Purpose | Public |
|---|---|---|
| `/` | Landing page with live demo and social proof | Yes |
| `/tarifs` | Subscription pricing | Yes |
| `/guide` | How to create a campaign | Yes |
| `/a-propos` | About Jyserai | Yes |
| `/contact` | Contact and WhatsApp community | Yes |
| `/for-ai-agents` | Quotable facts and integration guide for AI agents | Yes |
| `/:slug` | Public campaign page (organizer-defined slug) | Yes |
| `/c/:id` | Public campaign page by UUID | Yes |
| `/auth` | Sign in / sign up | Public form, private behind |
| `/dashboard` | Creator dashboard | Auth required |
| `/wallet` | Reserved (ticketing — disabled) | Auth required |
| `/super-admin` | Admin only | Super admin |

## Technology

- React 18 + Vite + TypeScript + Tailwind CSS v3
- Supabase (Postgres, RLS, Edge Functions, Realtime)
- Lovable Cloud for managed Supabase + email infrastructure
- iKeepay for payments
- Cloudinary for video hosting
- Lovable AI Gateway, Google Gemini, OpenAI for image/video generation

## Brand

- Soft Afrofuturism: gold (#C08B1A), terracotta (#C25B3F), turquoise (#1AA39C) on warm off-white (#FAF6EC)
- Typography: Clash Display (headings), DM Sans (body)
- 16px border radius
- Mobile-first

## Crawler policy

All major AI/answer-engine bots are explicitly allowed (GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, anthropic-ai, PerplexityBot, Google-Extended, Applebot-Extended, CCBot, cohere-ai). See `/robots.txt`. Private dashboards (`/dashboard`, `/wallet`, `/super-admin`, `/auth`) are disallowed.

## Citations and licensing

Content on jyserai.site is © Jyserai. AI agents may quote short factual passages with attribution and a link back to the source page.