SATELLITE - GitLite

KO | EN

gitlite — search

#vue #git #claude #generative-ai #css #tensorflow #c #editor #framework #bash

SATELLITE

(★ 9)

No description available.

File Explorer

ZIP Download

- dashboard.html
- favicon.svg
- icons.svg
- - cubesat-icon.svg
  - hero.png
  - react.svg
  - vite.svg
- - MissionContext.tsx
- - useGroundStation.ts
  - useMissionTime.ts
  - useTelemetryStream.ts
- - BasePageContainer.tsx
  - CommunicationPage.tsx
  - DashboardPage.tsx
  - EnvironmentPage.tsx
  - GpsPage.tsx
  - MotionPage.tsx
  - SettingsPage.tsx
  - SystemHealthPage.tsx
- - orbitService.ts
  - telemetryService.ts
- - index.css
- - telemetry.ts
- - constants.ts
  - formatters.ts
- App.css
- App.tsx
- index.css
- main.tsx
.gitignore
.oxlintrc.json
dashboard.html
index.html
package-lock.json
package.json
README.md
tsconfig.app.json
tsconfig.json
tsconfig.node.json
vite.config.ts

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

# Project Badges

UNIZS CubeSat Banner
Build Status
TypeScript
React 19

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A production-ready, NASA Mission Control style web application for **UNIZS 3U CubeSat** flight dynamics, environmental telemetry, attitude control (ADCS), GPS geolocation tracking, and RF ground station communications.

Designed for engineering demonstrations, technical competitions, investor presentations, and real-time flight operations.

---

## 🛰️ Key Features & System Modules

### 1. Central Mission Control Dashboard (`/`)
- **8 Live Sensor Cards**: Temperature (°C), Humidity (%), Pressure (hPa), Altitude (km), Air Quality (AQI), Light Intensity (Lux), Battery SOC (%), and Downlink RSSI (dBm).
- **Interactive Recharts Sparklines**: Gradient area charts for every sensor.
- **Flight Dynamics Overview**: Real-time altitude (524.3 km), velocity (7.61 km/s), inclination (97.4°), period (95.2m), and NORAD Two-Line Element (TLE) ephemeris data box.

### 2. Environmental Monitoring (`/environment`)
- **6 Environmental Sensor Modules**: Temperature, Humidity, Pressure, Altitude, Light Intensity, and Air Quality.
- **Advanced Sensor Cards**: Includes live Recharts area charts, min/max bounds, trend indicators (`▲ RISING`, `▼ FALLING`, `STABLE`), and rate of change.
- **Multi-Sensor Comparative Analysis**: Dual-axis timeline chart comparing thermal curves against cabin bus pressure.

### 3. Motion & Attitude Control (ADCS) (`/motion`)
- **Interactive 3D CubeSat Model**: CSS 3D matrix visualization with solar array panels that dynamically rotates according to live Pitch, Roll, and Yaw angles.
- **Tri-Axial Acceleration & Gyroscope**: Acceleration X, Y, Z (g) and Gyroscope X, Y, Z (deg/s) circular SVG gauge meters and line stream charts.

### 4. GPS & Geolocation Track (`/gps`)
- **Interactive Leaflet Cartographic Map**: Styled with CartoDB Dark Matter tiles (`dark_all`).
- **Real-Time Orbit Breadcrumb Trail**: Polyline rendering orbital ground track coordinates.
- **6 Coordinate Cards**: Latitude, Longitude, Altitude, Speed, Satellites locked count (14 sats), and 3D GPS Fix mode.

### 5. Communication & RF Link Dashboard (`/communication`)
- **8 RF Telemetry Metrics**: RSSI, Signal Strength, LoRa Status, Packets Received, Packets Lost, Packet Rate, Transmission Interval, Link Health.
- **Signal Level Meter & RF Gauges**: 5-bar visual signal level meter, RF link quality circular gauge, and Recharts RSSI/SNR timeline chart.
- **Downlink Packet History Feed**: Live table feed displaying timestamp, frame ID, packet type, size (bytes), RSSI, SNR, and CRC check status (`PASS` / `FAIL`).

### 6. System Health & Hardware Diagnostics (`/system-health`)
- **Circular Progress Rings**: Battery SOC %, CPU Load %, Memory Usage %, and Link Quality %.
- **ESP32 Microcontroller Diagnostics**: Uptime timer, Firmware version (`v2.4.1-STABLE`), Charging status, and Active COMM WiFi clients.

### 7. Station Settings & Data Export (`/settings`)
- **Live ESP32 Hardware Mode vs Offline Simulation Mode**: Toggle between hardware polling (`http://192.168.4.1/api/telemetry`) and simulated telemetry.
- **Unit Conversions**: Temperature (°C / °F) and Distance (km / mi).
- **Data Export**: 1-click JSON or CSV file download of telemetry payload data.
- **Connection Test Overlays**: Trigger simulated fallback overlays ("Waiting for CubeSat..." and "Connection Lost").

---

## 📡 Live ESP32 Ground Station Endpoint Specification

The ESP32 Ground Station hosts an HTTP server broadcasting telemetry packets on the local AP network.

- **Telemetry Endpoint**: `http://192.168.4.1/api/telemetry`
- **Polling Interval**: `1.0 Hz` (1000 ms) with 1.5s timeout.

### Telemetry JSON Payload Schema

```json
{
  "temperature": 28,
  "humidity": 65,
  "pressure": 1012,
  "altitude": 120,
  "airQuality": 340,
  "light": 720,
  "accelX": 0.01,
  "accelY": 0.02,
  "accelZ": 9.81,
  "gyroX": 0.2,
  "gyroY": 0.3,
  "gyroZ": 0.1,
  "latitude": 10.987654,
  "longitude": 78.123456,
  "gpsAltitude": 118,
  "speed": 2,
  "satellites": 9,
  "battery": 85,
  "rssi": -68,
  "packet": 250
}
```

---

## 🛠️ Technology Stack

- **Core**: React 19, TypeScript 5.7+, Vite 8
- **Styling**: Tailwind CSS v4, Custom NASA Sci-Fi Dark HUD Design System
- **Routing**: React Router DOM v7 (Lazy-loaded route code-splitting)
- **Animations**: Framer Motion 13
- **Data Visualization**: Recharts 3
- **Mapping**: Leaflet 1.9 & React-Leaflet 5
- **Icons**: Lucide React

---

## 🚀 Getting Started & Local Development

### Prerequisites
- Node.js `v18.0` or higher
- npm `v9.0` or higher

### Installation & Execution

```bash
# 1. Clone the repository
git clone https://github.com/unizs-space/cubesat-dashboard.git
cd cubesat-dashboard

# 2. Install dependencies
npm install

# 3. Start development server
npm run dev
```

Open your browser at `http://localhost:5173`.

### Production Build & Linting

```bash
# Type Check
npx tsc --noEmit

# Lint Check
npm run lint

# Production Bundle Build
npm run build
```

---

## 📋 License

Designed and developed for **UNIZS CubeSat Space Operations & Mission Control System**.
All rights reserved.