> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flynet.org/llms.txt
> Use this file to discover all available pages before exploring further.

# About Flynet

> Build on the restaurant economy. Get FLY.

# Build on Flynet

Flynet is the developer surface for Blackbird: the APIs, payment rails, and \$FLY rewards that power the dining network, opened up for you to build on.

## Why build on Flynet

<CardGroup cols={3}>
  <Card title="A network that's already busy" icon="utensils">
    Real members dining at real restaurants, with relationships across some of the best rooms in the country. You're not seeding a directory from zero; you're building on a network that already shows up.
  </Card>

  <Card title="Rails that already carry weight" icon="shield-check">
    Payments and \$FLY rewards run in production today, moving real value across live wallets. Build on infrastructure that's already doing the work, not a sandbox waiting for its first call.
  </Card>

  <Card title="Data you can trust" icon="database">
    Authenticated profiles, verified check-ins, real spend. Ground truth about how people actually dine, not a model's best guess.
  </Card>
</CardGroup>

## What to build

<CardGroup cols={3}>
  <Card title="Restaurant network growth" icon="chart-line" href="/getting-started" />

  <Card title="Consumer discovery" icon="map" href="/getting-started" />

  <Card title="Data visualizations" icon="chart-bar" href="/getting-started" />

  <Card title="Data marketplaces" icon="store" href="/getting-started" />

  <Card title="Consumer marketplace tooling" icon="cart-shopping" href="/getting-started" />

  <Card title="Third-party tools" icon="puzzle-piece" href="/getting-started" />

  <Card title="Payments" icon="credit-card" href="/concepts/payments" />
</CardGroup>

We'd love to hear what else fits the network. [Apply to build on Flynet](/getting-started).

## What you can build today

The first Flynet API surfaces (Discovery, member context, and Payments)
are live in staging. Discovery gives you read access to restaurants
and locations. Member context gives you the authenticated member's
profile, status, wallets, tags, and check-ins via `/users/me/*`.
Payments lets approved partners accept FLY-funded transactions on
behalf of merchants.

* **Restaurants**: brand-level metadata, cuisine, and image assets
* **Locations**: physical venues with address, geo, weekly hours, and reservation fields
* **Member context**: the authenticated member's profile, status, wallets, tags, and check-ins (`/users/me/*`)
* **Memberships**: the member's restaurant membership records
* **Check-ins**: visit records with embedded venue context (filters optional)
* **Payments**: accept FLY-funded payments from Blackbird members on behalf of your merchants

A published TypeScript SDK is the supported way to build on all of
this: [`@flynetdev/core`](/concepts/typescript-client) for typed
backend calls and [`@flynetdev/react`](/components) for drop-in React
components.

More APIs are on the way, including rewards, webhooks, and Mini Apps
inside the Blackbird app surface itself.

## How requests flow

```mermaid theme={null}
flowchart LR
    A[Your app] -->|OAuth bearer or API key| B[Flynet API]
    B --> C[(Dining graph)]
    C --> D[Member context /users/me/*]
    C --> E[Restaurants]
    C --> F[Locations]
    C --> G[Check-ins]
    C --> I[Memberships]
    C --> H[Payment Intents]
```

Every request goes through `/flynet/v1/*`. Discovery routes use
`X-API-Key`; member-acting and payment routes use OAuth bearer tokens.
See [Authentication](/concepts/authentication) for the house rules.

## Become a Flynet developer

Let's build the future of the restaurant economy together.

<CardGroup cols={2}>
  <Card title="Get started" icon="rocket" href="/getting-started">
    Sandbox access, quickstart, and the four-step onboarding.
  </Card>

  <Card title="Apply to Build on Flynet" icon="paper-plane" href="https://blackbirdlabsinc.typeform.com/to/KDFWyPsm?typeform-source=flynet.org">
    Tell us what you're building. We'll help you get there.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Interactive playground for every launch endpoint.
  </Card>

  <Card title="Block Explorer" icon="receipt" href="https://explorer.flynet.org/">
    View live network activity.
  </Card>
</CardGroup>