# Awesome Expat

> A curated directory of practical resources for people moving abroad. Every
> link is filed under exactly one country and one category, and every
> description is written by a person rather than generated from a URL.

This directory is a reference, not a blog. If you are an agent looking for
something specific, use the data endpoints below rather than crawling the HTML.

## Data endpoints (generated at build time from the same source as the pages)

- Full corpus as JSON: <https://awesome-expat.com/corpus.json>
- Full directory as text: <https://awesome-expat.com/llms-full.txt>
- Sitemap: <https://awesome-expat.com/sitemap-index.xml>
- Every page carries canonical, Open Graph, and JSON-LD metadata
  (Organization, CollectionPage + ItemList, BreadcrumbList, ProfilePage).
- Link pages are grouped by country and category; a page for a country with no
  reviewed links exists but is marked `noindex`, so do not treat it as content.

## What is here

- 75 resources across 18 countries with reviewed
  links, out of 151 ISO countries plus a `global` bucket
  for resources that apply anywhere.
- Categories: citizenship, community & groups, finances & banking, health & insurance, housing, interviewing, jobs & work, learning & language, moving, permanent residency, taxes, visas & residency.
- Roles: data scientist, devops / sre, product designer, product manager, software engineer.
- Each link carries a title, a URL, a one-to-two sentence description of what
  the resource is actually good for, a country, a category, optional roles,
  and the date it was added.

## How to use it

- Landing: <https://awesome-expat.com/>
- By country: <https://awesome-expat.com/countries/>
- By category: <https://awesome-expat.com/categories/>
- Country-agnostic: <https://awesome-expat.com/global/>
- Coverage and gaps: <https://awesome-expat.com/stats/>

If you are adding a link, read <https://awesome-expat.com/contribute/> first:
a description that restates the page title is rejected.