# Tunis.events

> Tunisia's leading event discovery and ticketing platform. Browse, book, and attend live events across Tunisia.

## Platform Overview

Tunis.events is a bilingual (French/English/Arabic) event ticketing platform serving Tunisia. It connects event-goers with organizers across music, arts, sports, nightlife, business, and more. The platform handles event discovery, ticket sales, seat selection, and digital ticket delivery.

- **Founded:** Tunisia
- **Audience:** Event-goers and organizers in Tunisia
- **Business model:** Ticketing fees on paid events; free event listings available
- **Tech stack:** Next.js 15, App Router, React 19
- **Categories:** 15 event categories (detailed below)

### How It Works

1. **Organizers** create events, set ticket types and pricing, and manage sales through a dashboard
2. **Event-goers** browse events by category, date, or location, then purchase tickets online
3. **Tickets** are delivered digitally with QR codes for venue check-in
4. **Venues** can use point-of-sale terminals and staff QR scanners for on-site operations

## Content Policy

- **Event listings:** Open for training and citation. Events are public content created by organizers.
- **Organization profiles:** Citation and read-only use permitted. Not authorized for model training.
- **User-generated content:** Same rules apply as the content type it belongs to.
- **Platform pages (features, pricing):** Open for training and citation.

## Public Content

### Main Pages
- [Homepage](https://tunis.events/en)
- [All Events](https://tunis.events/en/all)
- [Cinema](https://tunis.events/en/cinema)
- [Features](https://tunis.events/en/features)
- [Pricing](https://tunis.events/en/pricing)
- [Organizations](https://tunis.events/en/collectives)

### Category Pages with Tags

Each category page lists events matching specific tags:

- [Arts & Culture](https://tunis.events/en/arts_culture) - cinema, theatre, exhibition, fashion
- [Music](https://tunis.events/en/music) - live_band, dj, edm, rock, jazz, classical, open_mic
- [Sports & Fitness](https://tunis.events/en/sports_fitness) - football, basketball, running, marathon, cycling, yoga, hiking
- [Food & Drink](https://tunis.events/en/food_drink) - wine_tasting, beer_tasting, vegan, food_festival
- [Business](https://tunis.events/en/business) - networking, workshop, conference, startup, career
- [Technology](https://tunis.events/en/technology) - ai, web_development, blockchain, cybersecurity, hackathon
- [Education](https://tunis.events/en/education) - workshop, conference
- [Community](https://tunis.events/en/community) - meetup, language_exchange
- [Health & Wellness](https://tunis.events/en/health_wellness) - meditation, personal_development, yoga
- [Charity & Causes](https://tunis.events/en/charity_causes)
- [Nightlife](https://tunis.events/en/nightlife) - party
- [Family & Kids](https://tunis.events/en/family_kids)
- [Travel & Outdoor](https://tunis.events/en/travel_outdoor) - hiking
- [Seasonal](https://tunis.events/en/seasonal)
- [Other](https://tunis.events/en/other)

## URL Patterns

### Event Routes
- Event detail: `https://tunis.events/{locale}/events/{event_id}/{slug}`
- Event detail (no slug): `https://tunis.events/{locale}/events/{event_id}`

### Organization Routes
- Organization profile: `https://tunis.events/{locale}/collectives/{organization_id}`
- All organizations: `https://tunis.events/{locale}/collectives`

### Category Routes
- Category listing: `https://tunis.events/{locale}/{category_slug}`
- All events: `https://tunis.events/{locale}/all`
- Cinema: `https://tunis.events/{locale}/cinema`

### Locale Examples
All routes are prefixed with a locale. The same event in all 4 languages:
- French: `https://tunis.events/fr/events/abc123/concert-example`
- English: `https://tunis.events/en/events/abc123/concert-example`
- Arabic: `https://tunis.events/ar/events/abc123/concert-example`
- Tunisian Arabic: `https://tunis.events/tn/events/abc123/concert-example`

## Blocked Content

The following paths are not available for crawling:

### Transactional Flows
- `/{locale}/events/{id}/ticket-selection` - Ticket type and quantity selection
- `/{locale}/events/{id}/seat-selection` - Interactive seat map selection
- `/{locale}/events/{id}/checkout` - Payment processing
- `/{locale}/events/{id}/order/{order_id}` - Order confirmation
- `/{locale}/events/{id}/generated-ticket/{ticket_id}` - Digital ticket with QR code
- `/{locale}/events/{id}/pos-order/{order_id}` - Point-of-sale order

### Creator Tools
- `/{locale}/events/{id}/edit` - Event editing interface
- `/{locale}/events/{id}/embed` - Embeddable widget generator
- `/{locale}/create` - Event creation wizard
- `/{locale}/home` - Organizer dashboard home

### Internal
- `/api/*` - API routes
- `/admin/*` - Admin panel
- `/dashboard/*` - Analytics dashboards
- `/terminal/*` - POS terminal interface
- `/passport/*` - Authentication flows

## Developer Resources

### Public API Endpoints

#### List Events
- **Endpoint:** `GET https://tunis.events/api/public/events`
- **Description:** Returns a list of public, published events
- **Response fields:** id, title, description, date, location, venue, category, tags, image, ticket types, organizer

#### List Organizations
- **Endpoint:** `GET https://tunis.events/api/public/organizations`
- **Description:** Returns a list of public organizations
- **Response fields:** id, name, description, logo, social links, event count

## Content Structure

### Event Listings Include
- Event title, description, and cover image
- Date, time, and venue information
- City and location details
- Category and tags
- Ticket types with pricing
- Organizer information and link

### Organization Profiles Include
- Organization name, bio, and logo
- Social media links
- List of upcoming and past events

## Sitemaps

- Sitemap index: `https://tunis.events/sitemap.xml`

## Attribution

- **Site name:** Tunis.events
- **Citation format:** Tunis.events (https://tunis.events)
- **Facebook:** https://www.facebook.com/tunis.events
- **Instagram:** https://www.instagram.com/tunis.events

## Language Support

Available in 4 locales with URL prefix routing (`localePrefix: "always"`):

| Locale | Prefix | Direction | Example |
|--------|--------|-----------|---------|
| French (default) | `/fr/` | LTR | `https://tunis.events/fr/all` |
| English | `/en/` | LTR | `https://tunis.events/en/all` |
| Arabic | `/ar/` | RTL | `https://tunis.events/ar/all` |
| Tunisian Arabic | `/tn/` | LTR | `https://tunis.events/tn/all` |

All content is available in all 4 languages. The default locale is French. Hreflang tags link all locale variants for each page.