expo

expo/fyi

Little bits of information that you may find useful when interacting with Expo tools and service. Append the markdown filename to https://expo.fyi/ to get a quick link to it.

View on GitHub Back to listing

1.1kstars 435forks 71contributors Shell

README.md

View on GitHub

# expo.fyi

**tl;dr:** it's a tool to link people to markdown files in [https://github.com/expo/fyi](https://github.com/expo/fyi) with a concise and pretty link. For example, [https://expo.fyi/bundle-identifier](https://expo.fyi/bundle-identifier)

## What is it?

This website is a useful URL shortener that redirects users to a markdown file on the [https://github.com/expo/fyi](https://github.com/expo/fyi) repository. For example, [https://expo.fyi/bundle-identifier](https://expo.fyi/bundle-identifier) will redirect the user to [https://github.com/expo/fyi/blob/master/bundle-identifier.md](https://github.com/expo/fyi/blob/master/bundle-identifier.md).

It is useful to remove any friction to create a shareable link to a persistent explanation of some piece of knowledge that is useful to developers using Expo tools.

## Why might I want to use this?

Imagine that you're working on [Expo CLI](https://docs.expo.dev/more/expo-cli/) and want to add more context on some terminology that you are using in a prompt to the user. Maybe you need to ask them for a "bundle identifier". You want to make sure that the user has easy access to more information about what that means, but you don't want to inline a whole explanation of it and crowd the interface. At the same time, you can't be bothered to create a docs page for this, or maybe the existing docs page doesn't provide the most relevant context for the situation the user is in. That's understandable. So instead let's just create an FYI!

## How do I create an FYI?

- Go to [https://github.com/expo/fyi](https://github.com/expo/fyi).
- Click "Create a new file".
- Pick a name for it and include the `.md` extension. If you are teaching people about the "tunnel" connection type in expo-cli, maybe you want to call it `tunnel-connection.md` and then the URL will be [https://expo.fyi/tunnel-connection](https://expo.fyi/tunnel-connection).

## FYI

- You can add any arbitrary string like `this-does-not-exist` to the URL and it will just bring you to the GitHub 404 pages: [https://expo.fyi/this-does-not-exist](https://expo.fyi/this-does-not-exist). You probably do not want to do this, so instead create a file and link to it, and don't delete the file if it's linked to from somewhere already.
- If you go to [https://expo.fyi](https://expo.fyi) it will just redirect you to the GitHub repo.
- You can create your own domain like this by cloning [https://github.com/expo/expo-fyi](https://github.com/expo/expo-fyi) &mdash; a small service that you can deploy to, for example, Vercel or Netlify. Customize the URLs it uses in [index.js](https://github.com/expo/expo-fyi/blob/master/index.js).

Repository info

Default branch: main
Latest version: —
Created: 17/03/2020
Last activity: 21/10/2026
License: —
Open issues: 34
Watchers: 20

Topics

expo troubleshooting

Contributors

brentvatne

113 contributions

EvanBacon

34 contributions

keith-kurak

26 contributions

amandeepmittal

22 contributions

quinlanj

21 contributions