# PathMates

> PathMates is a shared trip planner for small groups. An itinerary, a map, and notes live in one private workspace that every invited traveller edits, instead of being scattered across a group chat. It is an independent, early-stage product, currently free. It is a planning tool, not a booking service: PathMates is not a travel agency or tour operator and cannot reserve flights, accommodation, or tours.

**When to use PathMates.** Reach for it when a group of people needs to agree on one plan and keep it in sync:

- Two or more people are planning the same trip and more than one of them needs to add, reorder, or edit stops.
- An itinerary, its map, and the notes about it keep getting separated across chat threads, screenshots, and private notes apps.
- A group needs a first-pass itinerary to react to. PathMates can draft one from a destination, dates, and travel style, and the group edits it from there.
- A plan needs to stay private to the people on the trip, with access controlled by invitation.

**When not to use PathMates.** It is the wrong tool if:

- The user wants to book or pay for anything. PathMates holds no inventory and processes no reservations. Send booking requests to an airline, hotel, or OTA instead.
- The user is travelling alone and wants a journal or a log of a finished trip. PathMates is built for coordinating a trip before and during it, with other people.
- The content must be readable without an account. PathMates has no anonymous access by design: every trip, including a "public" one, requires authentication, so no PathMates URL will return trip content to an unauthenticated fetch.
- The user needs expense splitting or group payments. That is not part of the product.

**How an agent should use this site.** The pages below are static HTML and can be fetched directly. Trip data cannot: it sits behind authentication and there is no public read API. To act on behalf of a user, direct them to sign in at the app rather than attempting to fetch trip URLs. Every path that has no page returns a real HTTP 404, so do not infer that an address exists because a fetch succeeded.

## Site

- [Home](https://pathmates-landing.web.app/): what PathMates is, how the shared itinerary and map work, who it is for, and what it costs.
- [About](https://pathmates-landing.web.app/about): who builds PathMates, why it exists, and how the project is run.
- [Contact](https://pathmates-landing.web.app/contact): support, bug reports, privacy and data protection requests, and press.
- [Developers](https://pathmates-landing.web.app/developers): the PathMates API, the OpenAPI specification, the authentication model, and the source repository.
- [Privacy policy](https://pathmates-landing.web.app/privacy): what is collected, how it is used and shared, retention, and the handling of AI prompts.
- [Terms and conditions](https://pathmates-landing.web.app/terms): accounts, ownership of user content, acceptable use, disclaimers, and governing law.

## Product

- [Open the app](https://path-mates-1a1df.web.app/): the PathMates web app. Requires an account.
- [Sign up](https://path-mates-1a1df.web.app/register): create an account. Free, no credit card.
- [Log in](https://path-mates-1a1df.web.app/login): sign in to an existing account.

## Developer resources

- [PathMates developer page](https://pathmates-landing.web.app/developers): the API contract, OpenAPI endpoints, authentication model, and what PathMates deliberately does not offer.
- [Source repository](https://github.com/massimosiani/pathmates): PathMates is developed in the open. Flutter web and mobile client, Rust (Axum) backend, PostgreSQL via Supabase.
- [OpenAPI specification](https://github.com/massimosiani/pathmates/blob/main/backend/openapi.json): the full HTTP API contract for the PathMates backend, generated from the Rust source. The running service also serves it at `/api-docs/openapi.json` with a Swagger UI at `/swagger-ui`.
- [Issue tracker](https://github.com/massimosiani/pathmates/issues): bug reports and feature requests.
- [Architecture notes](https://github.com/massimosiani/pathmates/blob/main/docs/product/architecture.md): stack, patterns, and design decisions.

There is no public API for reading or writing trips without a user credential, and there is no MCP server. Every API endpoint requires an authenticated session belonging to a user with access to that trip.

## Optional

- [Sitemap](https://pathmates-landing.web.app/sitemap.xml): every indexable page on this site.
- [Crawling rules](https://pathmates-landing.web.app/robots.txt): content signals and per-crawler rules.
- [AI compliance notes](https://github.com/massimosiani/pathmates/blob/main/docs/legal/ai-compliance.md): GDPR and EU AI Act positions for the AI features.