Skip to content

Huginn-ai/astronomyChart

Repository files navigation

🌠 Astronomy Chart

A simple, interactive web app that shows which first-magnitude stars are visible from a given location and time. This is very friendly for beginner of astronomy to get familiar with the sky. Built with SvelteKit and deployed on Vercel.

👉 Live Demo: https://mr-sky.vercel.app/


✨ Features

  • 🌍 Input your city name or latitude / longitude
  • ⏰ Select a date and time to view the night sky
  • 🌌 Displays which famous stars are visible, including:
    • Sirius (天狼星)
    • Vega (织女一)
    • Betelgeuse (参宿四)
    • Arcturus (大角)
    • Altair (河鼓二)
    • ...and many more!
  • 🎯 Simple interface, no external graphics or libraries required

🛠️ Tech Stack

  • Frontend: SvelteKit
  • Language: TypeScript
  • Deployment: Vercel
  • Styling: CSS / HTML minimal UI

🚀 Getting Started

To run locally:

# 1. Clone the repository
git clone https://github.com/Huginn-ai/astronomyChart.git

# 2. Enter the project directory
cd astronomyChart

# 3. Install dependencies
npm install
npm install svelte-i18n

# 4. Run the development server
npm run dev

Then open your browser to http://localhost:5173 (or whichever port is shown).


🧭 Project Structure

astronomyChart/
├── src/
│   ├── routes/          # Pages (+page.svelte, +layout.svelte)
│   ├── lib/             # Star data, coordinate conversion
│   └── app.html         # HTML entry point
├── static/              # Public assets (favicon, robots.txt)
├── package.json
├── svelte.config.js
└── vite.config.ts

🌙 Future Improvements

  1. 📍 Display precise positions for each star and constellation ✅finished on 10.10.2025 (e.g. 15° west of north, 45° above the horizon)
  2. 🌐 Add language selection — switch between English and 中文 ✅finished on 10.10.2025
  3. 🌌 Expand and update the star catalog with more celestial objects
  4. 🔗 Create dedicated pages for each star and constellation
    — click a name to view detailed descriptions, visibility data, and mythology
  5. 🎨 Beautify the background of home page
  6. 📊 Write an algorithm to decide how easy can the target been seen, and range the targets in this order (from the easiest to the hardest)
  7. 🗺️ Create a sky map for the celestial. ✅finished on 10.16.2025

🪐 Author

Created by Caiqi (Maggie) Rao (github: Huginn-ai) Discord: mingerke_67210

About

a website for star gazing

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors