Skip to content

kaBeech/star-crossed

Repository files navigation

StarCrossed

A tool for finding a special spot in the universe

Created for the Deno KV Hackaton

About

StarCrossed is inspired by this xkcd comic:

xkcd Christmas GPS comic

...but in space!

The basic idea is to input the birthdays of you and a loved one, and return a set of celestial coordinates special to the two of you

In addition to these coordinates, you'll also receive the name of the star closest to these coordinates (within 25 parsecs of Earth), a link to some more information about this star, and a link to an interactive map of the area your coordinates reside in

If the location is out of your starship's range, is too crowded when you get there, or isn't visible from your porch, fear not! Try entering in your birthdays in the reverse order - you'll get a different response this way

Have fun!

Screenshots

Frontend Demo Screenshot 1: Frontend Demo Screenshot 1

Frontend Demo Screenshot 2: Frontend Demo Screenshot 2

Demo Info Link (external website) Screenshot: Demo Info Link (external website) Screenshot

Technical notes

The main route is a get request on /star-crossings/:birthdays, which returns StarCrossingData as JSON

The birthdays are expected to be in the following format: yyyy-mm-dd,yyyy-mm-dd

For example, a get request to hungry-heron-21.deno.dev/star-crossings/1960-1-1,1960-4-17 will return StarCrossingData

The only other route currently implemented is /star-catalog, which lists all the stars loaded into KV

A frontend demo is available at kabeech.com/fun/star-crossed/

To start the server: deno tasks dev in the root directory

Acknowledgements

Very special thanks go out to the Internet Stellar Database and the Universe Guide for the info links, skyMap.org for the skyMaps, and the Strasbourg Astronomical Data Center for the starData

About

A tool for finding a special spot in the universe

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages