From 5c63088164dc15c4be90e5d43f28618a1a3c0893 Mon Sep 17 00:00:00 2001
From: netecho <miao_jf@hotmail.com>
Date: Sat, 17 May 2025 09:13:47 +0800
Subject: [PATCH] Add usage instructions

---
 README.md | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 724bdbe..9cdaeb8 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,26 @@
-# solarsystem
+# Solar System 3D Simulation
+
+This project provides a simple 3D visualization of the solar system built with [Three.js](https://threejs.org/). It renders the Sun, planets and their moons with controls for adjusting the view and simulation speed. The interface supports both desktop and mobile devices.
+
+## Prerequisites
+
+- A modern web browser with JavaScript enabled and WebGL support (Chrome, Firefox, Safari, Edge, etc.).
+- Optionally, a small HTTP server if you want to avoid potential cross-origin restrictions when opening files directly from disk.
+
+## Running the Demo
+
+1. Clone or download this repository.
+2. Open `index.html` in your browser. You can double‑click the file or serve it via a local web server.
+3. If textures or other resources fail to load when opened directly, start a simple server from the project directory and browse to `index.html` from that server. For example using Python 3:
+
+   ```bash
+   python3 -m http.server 8000
+   ```
+
+   Then visit `http://localhost:8000/index.html` in your browser.
+
+## Usage
+
+Use your mouse (or touch on mobile) to rotate, zoom and explore the planets. Additional controls are available in the on-screen panel.
+
+Enjoy exploring the solar system!