https://github.com/domnantas/airplane-disco

✈️🪩 Airplane scatter prediction web app
https://github.com/domnantas/airplane-disco

amateur-radio cloudflare typescript vue

Last synced: 17 days ago
JSON representation

✈️🪩 Airplane scatter prediction web app

• Host: GitHub
• URL: https://github.com/domnantas/airplane-disco
• Owner: domnantas
• License: gpl-3.0
• Created: 2022-10-02T16:51:13.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-02-26T20:03:35.000Z (10 months ago)
• Last Synced: 2024-12-17T03:08:07.556Z (20 days ago)
• Topics: amateur-radio, cloudflare, typescript, vue
• Language: Vue
• Homepage: https://airplanedis.co
• Size: 529 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Airplane Disco ✈️🪩

[Airplane Scatter](https://en.wikipedia.org/wiki/Airplane_scatter) prediction

calculator

![Amateur radio operator unable to contact another operator due to curvature of the Earth. However, they are able to establish a contact by bouncing off radio waves on an airplan overflying between them](how-airplane-scatter-works.png)

This project uses [Vue 3](https://vuejs.org/),

[Typescript](https://www.typescriptlang.org/), [Vite](https://vitejs.dev/), and

[Tailwind](https://tailwindcss.com/). In order to proxy API requests it

uses

[Cloudflare Pages Functions](https://developers.cloudflare.com/pages/platform/functions/).

Deployed on [Cloudflare Pages](https://pages.cloudflare.com/).

### [Roadmap](https://github.com/users/domnantas/projects/1?query=is:open+sort:updated-desc)

## Development

Copy `.env.example` to `.env.local`

Copy `.dev.vars.example` to `.dev.vars`.

Get an API key from

[ADS-B Exchange](https://www.adsbexchange.com/free-aircraft-scatter-data-via-rapidapi/).

You'll have to register on [RapidAPI](https://rapidapi.com) and subscribe to the

API.

Update `AIRCRAFT_SCATTER_API_KEY` in `.dev.vars`

```sh

# Set Node version

n auto

# Install dependencies

npm install

# Run cloudflare proxy + Vite development server

npm run dev

```

Development server will be available on http://localhost:4220

### What's the difference between `4220` and `5173` ports?

Great question. `5173` (kinda looks like `VITE`) is _Vite_ development server port. `4220` (kinda looks like Airbus `A220`) is _Cloudflare_ dev server port. Cloudflare proxies requests to Vite:

```

Your browser -> Cloudflare -> Vite

```

It works the same way in production. In this project, we use Cloudflare as a

"backend" and it only processes `/airplanes` endpoint which responds with a

JSON.