Neon-dawn

Neon-dawn is a hackaton that can be organized by anyone with enough web knowledge.

To put it simply, the host shows a web page with the earth and the participants get a paper with instructions to launch a satellite onto that web page.

To be figured out

• How HTTP works, how request are conveyed.
• The concept of endpoints
• The concept of HTTP methods
• CORS 😍(😭)
• The WebSocket protocol
• The orbit of a satellite around the earth
• cos, sin functions

Setup (for the host)

Prerequisites

• Being in a private network, e.g.: everyone has an address under 10.66.66.0/24
• Deno installed
• Neon-dawn Repository installed
• Make sure you have received public/model/satellite.glb & public/textures/8k... from the git repository.

Commands

• deno task web - bundle the web page into /dist
• deno task dev - start the host server on port 80
• deno task client - start a webserver example (a satellite with weird orbit)

Keyboard inputs

• Space - Stop the camera rotation
• ArrowUp - Increment the rotation speed
• ArrowDown - Decrement the rotation speed
• l - Toggle the orbit controls (click on satellite -> orbit around it if orbit controls are enabled)
• o - Toggle satellite list

There are 2 modes for the app, 'remote' or 'local', 'remote' by default

• remote, wait for participant's webapp to register to display a satellite
• local, wait for the host to register a satellite

You can change the mode in the first line of src-web/main.ts. Then you'll need to bundle the app again deno task web

CORS - Warning ⚠️

CORS is likely to confuse many newcomers, they may need to add a header that looks like those, in order to the host to properly request the participant's web server.

# port 80, 10.66.66.4 being the host ip address in the private network
Access-Control-Allow-Origin=http://10.66.66.4 
Access-Control-Allow-Origin=http://10.66.66.4:81 
Access-Control-Allow-Origin=http://192.168.1.62:8000

Instructions

Here are the instructions for participants

• English instruction
• French instruction

Contributions

If you encounter any issue, create an issue on Github so I get notified and I can fix it.

I'm open to contributions or forks too 🤗.

A drawing of the main idea

Gallery

Weird Orbit	Test Orbit

Early stage demo

Having fun debugging