Need help with airport-codes?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

234 Stars 188 Forks 2.0K Commits 218 Opened issues


✈️ Making sense of those three-letter airport codes.

Services available


Need anything else?

Contributors list

Airport Codes

A website that tries to make sense of those three-letter airport codes.


If you'd like to add an airport or fix an error, please:

Working Locally

This repo has a lot of images, so may take some time to clone. If you'd like to speed up that process, you can clone only the latest (and not the entire commit history) by cloning with this command:

With SSH:

git clone --depth=1 [email protected]:lynnandtonic/airport-codes.git


git clone --depth=1

To run the site locally:

  • you will need node 8
    • if you use a tool like
      which respects
      this will be handled for you
    • otherwise will need to make sure that your shell is running node 8
  • run the following commands:
npm ci
npm run dev

Note: The web server may take 2-3 minutes to start.

Adding/Editing Airport Content

Airport content can be found in

in individual files. Use the three-letter airport code as the filename (e.g.

Content in each

  • id
    = three-letter code (e.g. phx)
  • name
    = airport name (Sky Harbor International Airport)
  • city
    = primary city name (Phoenix)
  • state
    = state name, if applicable (Arizona)
  • stateShort
    = state abbreviation, if applicable (AZ)
  • country
    = country name (USA)
  • description
    = description, accepts markdown, use * for emphasis on letters
  • imageCredit
    = name of photographer
  • imageCreditLink
    = URL of photographer's Flickr page

You can also optionally add for aid in searching:

  • city2
    = another city or country the airport may be known for

Adding a

file to
will automatically render it. You do not need to manually add the path anywhere.


  • Please use photos from Flickr that are licensed under Creative Commons.
  • If photos are not available on Flickr, please use Wikipedia with the same license.
  • Images should be named with this convention:
  • To generate the 4 sizes of the image (large, medium, small, and card):
    • Save out the image as a JPG at large size (1500px wide) with the filename
    • Please optimize images ( is a good tool to do that)
    • Run
      ./sharp.js assets/images/large/code.jpg
  • If you’d like to save out the image sizes manually, these are the sizes needed:

    • card - 220px height
    • small - 500px width
    • medium - 900px width
    • large - 1500px width
  • Add variable to

    . The code must match the airport code. So if an image is named
    you would add
    'abq': '',
    to the

Editing Templates

Most site content is written in Pug templates which produce the site HTML.

The Pug files are located in


Note that these aren't markdown files and the syntax and whitespace you use does matter quite a bit. See the Pug documentation to see how to use Pug.

Editing CSS

This site uses Stylus for preprocessing. Please follow the established indentation and commenting patterns.

Stylus files are located in


Declaration Order

Please use the following loose declaration order:

  • Box-model properties
  • Display and Positioning
  • Backgrounds
  • Borders
  • Box Shadows
  • Fonts and Colors
  • Other


GNU General Public License v3.0

Because of the Creative Commons licensed images used on this site, any derivatives CAN NOT be for commercial or paid use.


We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.