# Voyspark

> Voyspark is a travel platform combining trip planning, flight/hotel search, editorial content, and a social community for travelers. Built in 7 languages (pt-BR, pt-PT, en, es, fr, it, de) with English as the global default. Travelers plan trips with Spark AI, share trip reports, and find off-the-postcard destinations.

## Architecture

URLs are split into 3 categories. Crawlers and agents should respect this distinction.

- **Universal entities** (no locale prefix, canonical unique): user profiles, posts, hashtags, community detail pages, trips, live rooms, notifications.
- **Locale-prefixed content** (`/[locale]/`): editorial content (Journal, Destinations, Tools, Search hub, About). Each locale is its own indexable page with hreflang alternates.
- **UGC** (user-generated content): kept in the author's original language with `lang` attribute. Not translated automatically.

Full URL strategy: https://voyspark.com/docs/URL-I18N-STRATEGY.md (also in repo).

## Primary entry points

### Editorial (locale-prefixed)
- [Home](https://voyspark.com/) — landing
- [Journal](https://voyspark.com/en/journal) — long-form travel writing in 7 languages
- [Destinations](https://voyspark.com/en/destinations) — 60+ curated city guides
- [Search Hub](https://voyspark.com/en/search) — flights, hotels, cars, tours, trains, transfers, insurance
- [Tools](https://voyspark.com/en/tools) — Visa Checker, Pet Checker, Carbon Calc, Trip Cost, Miles Calc, Best Month Finder, Taste Quiz
- [Community Hub](https://voyspark.com/en/community) — feed of travelers' posts

### Universal entities
- [/@username](https://voyspark.com/@andreambrosio) — public traveler profiles
- [/comunidade/post/[id]](https://voyspark.com/comunidade/post/1) — individual post
- [/comunidade/[slug]](https://voyspark.com/comunidade/slow-travel) — themed community (7 official: slow-travel, foodies, family-smart, solo-women, off-postcard, miles-hacking, sustainable)
- [/hash/[tag]](https://voyspark.com/hash/lisboa) — hashtag aggregation
- [/trip/[id]](https://voyspark.com/trip/UUID) — public trip plan
- [/v/[token]](https://voyspark.com/v/TOKEN) — shared trip link

## Search API

These endpoints return JSON and can be called by agents. No auth needed for public reads (rate-limited by IP).

- `GET /api/search/spotlight?q=<query>&locale=<locale>` — unified search (articles, destinations, users, posts, hashtags, communities)
- `GET /api/search/flights?origin=<IATA>&destination=<IATA>&depart=<YYYY-MM-DD>[&return=<YYYY-MM-DD>][&adults=N]` — flight prices
- `GET /api/search/hotels?city=<name>&checkin=<date>&checkout=<date>[&adults=N]` — hotel availability
- `POST /api/trip-plans/simulator` — build a sample trip plan (no persistence)

Structured data (schema.org JSON-LD) is on every entity page: `Person`, `SocialMediaPosting`, `DefinedTerm`, `OnlineCommunity`, `TouristTrip`, `Article`.

## Sitemap

https://voyspark.com/sitemap.xml (index) — splits into 7 sub-sitemaps including `sitemap-entities.xml` for universal URLs without alternates.

## More

- Full docs and schemas: https://voyspark.com/llms-full.txt
- Strategy doc (governance): see repo `docs/URL-I18N-STRATEGY.md`
- Contact: https://voyspark.com/sobre/contato