Urban Sky SDK

Appearance

AI Assistant Guide ​

Use these prompts with AI assistants like ChatGPT, Claude, or GitHub Copilot to generate simple Urban Sky SDK implementations.

JavaScript/Node.js Implementation Prompt ​

Copy and paste this prompt into your AI assistant:

Create a simple Node.js script that connects to the Urban Sky SDK and logs balloon updates.

**Requirements:**
- Load the SDK from https://sdk.atmosys.com/runtime/js/current/loader.js
- Connect and listen for balloon:update events
- Log device locations when updates are received
- Use environment variables for the API token
- Include basic error handling

**Documentation links (please review for implementation details):**
- Getting Started: https://docs.atmosys.com/guide/getting-started
- JavaScript Guide: https://docs.atmosys.com/guide/javascript-sdk
- Examples: https://docs.atmosys.com/examples/basic-usage

**Provide:**
1. Simple main script file
2. Package.json with required dependencies
3. Example .env file

Keep it simple - just enough to connect and receive data.

Python Implementation Prompt ​

Copy and paste this prompt into your AI assistant:

Create a simple Python script that connects to the Urban Sky SDK and logs balloon updates.

**Requirements:**
- Load the SDK from https://sdk.atmosys.com/runtime/py/current/loader.py
- Connect and listen for balloon:update events
- Log device locations when updates are received
- Use environment variables for the API token
- Include basic error handling

**Documentation links (please review for implementation details):**
- Getting Started: https://docs.atmosys.com/guide/getting-started
- Python Guide: https://docs.atmosys.com/guide/python-sdk
- Examples: https://docs.atmosys.com/examples/basic-usage

**Provide:**
1. Simple main script file
2. Requirements.txt with dependencies
3. Example .env file

Keep it simple - just enough to connect and receive data.

Data Processing Prompt ​

For users who want to store and analyze balloon data:

Create a script that connects to the Urban Sky SDK and saves balloon data for analysis.

**Features needed:**
- Connect to Urban Sky telemetry feed
- Save balloon updates to JSON files
- Calculate distance between position updates
- Basic error handling and logging

**Documentation for reference:**
- Balloon Examples: https://docs.atmosys.com/examples/balloon-updates
- Error Handling: https://docs.atmosys.com/guide/error-handling

Choose JavaScript or Python and provide a simple, working solution. Focus on getting data saved first - additional features can be added later.

Web Dashboard Prompt ​

For users who want a simple web interface:

Create a basic web application that displays balloon data on a map.

**Core features:**
- Backend that connects to Urban Sky SDK
- Simple web page with a map
- Display balloon positions in real-time
- Basic error handling

**Documentation for reference:**
- SDK Guide: https://docs.atmosys.com/guide/javascript-sdk
- Examples: https://docs.atmosys.com/examples/basic-usage

Use simple technologies (Node.js + Express + Leaflet map). Focus on getting a working prototype first - advanced features can be added later.

What to Expect ​

✅ You'll Get ​

  • Working code that connects and receives data
  • Simple setup with clear instructions
  • Basic error handling for common issues
  • Environment configuration for your API token

🔧 You Can Add Later ​

  • Data storage - databases, file systems, etc.
  • Advanced error handling - retry logic, monitoring
  • Data processing - analytics, alerts, calculations
  • User interface - dashboards, mobile apps

Tips for Better Results ​

Be specific about your goal:

  • "I want to log balloon positions to a file"
  • "I need to send alerts when altitude drops"
  • "I want to display data on a simple web map"

Start simple, then expand:

  • Get the basic connection working first
  • Add one feature at a time
  • Refer to our examples for additional patterns

Follow-up Prompts ​

If you want to add features to your generated code:

  • "Add file logging to save all balloon updates"
  • "Include error recovery if the connection drops"
  • "Add a simple alert when altitude goes above 30,000 feet"
  • "Save data to a database instead of console logging"

Documentation Quick Reference ​

Essential reading:

When you need more:

Testing Your Code ​

Once you have a working implementation:

  1. Test the connection - verify it connects successfully
  2. Send a test message - use our test endpoint to verify data flow
  3. Check error handling - disconnect your internet briefly to test recovery
  4. Review our examples - compare your code to our working patterns

Need help? Start simple with the basic prompts above, then add features one at a time. Contact support at support@atmosys.com if you get stuck.

Copyright © 2024 Urban Sky