First version of CoBie

README.md

@@ -1,3 +1,72 @@
-# CoBiE
+# CoBiE Time System Calendar
 
-CoBiE Time System Calendar is a web-based interactive visualization of the CosmoChron Binary Epoch (CoBiE) time system. It displays real-time CoBiE timestamps alongside UTC/TAI clocks, lets you navigate through custom “Eonstrip” periods with tooltips, choose different timezones, and explore both core and extended cosmic time units. Fully responsive and styled with modern glassmorphism effects, it’s perfect for anyone curious about novel timekeeping frameworks.
+An interactive web app that visualizes the **CosmoChron Binary Epoch (CoBiE)** time system alongside standard UTC/TAI clocks, complete with an explorable calendar of “Eonstrip” periods and detailed breakdowns of cosmic time units.
+
+## Features
+
+- **Live CoBiE Clock**: Displays the current CoBiE timestamp, updating every second.
+- **UTC & TAI Display**: Shows both UTC and International Atomic Time (TAI) in human-readable format.
+- **Timezone Selector**: Switch between UTC, TAI, or any IANA timezone.
+- **Interactive Calendar**: Browse past and future Megasequences and Eonstrips with Prev/Next controls.
+- **Tooltips**: Hover or click on an Eonstrip card to see start/end times and duration.
+- **Manual Mode**: Enter any CoBiE timestamp to compare and calculate differences.
+- **Time Breakdown**: View core units (Galactic Year → Second) and optional extended units (Astralmillennia → Universal Eon).
+- **Responsive Design**: Adapts to mobile viewports with font scaling.
+- **Modern UI**: Glassmorphism, gradient text, animated hover effects, and CSS-backed glows.
+
+## Getting Started
+
+### Prerequisites
+
+- A modern web browser (Chrome, Firefox, Edge, Safari).
+
+### Installation
+
+1. **Clone the repository**  
+   ```bash
+   git clone https://github.com/your-username/cobie-time-system.git
+   cd cobie-time-system
+   ```
+
+2. **Open in browser**
+   Simply open `index.html` in your preferred browser:
+
+   ```bash
+   open index.html
+   ```
+
+   or double-click the file in your file manager.
+
+## Usage
+
+* **Live View**: On load, the app shows the current CoBiE time, UTC, and TAI.
+* **Navigate Periods**:
+
+  * ← / → buttons to move by Megasequence (or hold modifier keys for larger jumps).
+  * “Now” button to return to live mode.
+* **Manual Mode**: Click the CoBiE time to enter an arbitrary timestamp; press Enter or click elsewhere to apply.
+* **Compare Mode**: In manual mode, click the “Compare” field to set a second timestamp for difference calculations.
+* **Toggle Units**: Use “Show Cosmic Units” to reveal extended time units.
+
+## Project Structure
+
+```
+├── index.html       # Main HTML, styles, and scripts
+├── README.md        # This documentation
+└── assets/          # (Optional) images or external CSS/JS
+```
+
+## Contributing
+
+1. Fork the repository.
+2. Create your feature branch: `git checkout -b feature/YourFeature`.
+3. Commit your changes: `git commit -m "Add YourFeature"`.
+4. Push to the branch: `git push origin feature/YourFeature`.
+5. Submit a Pull Request.
+
+Please follow standard JavaScript style and include comments for new functionality.
+
+## License
+
+This project is released under the [WTFPL](LICENSE).
+Feel free to use, modify, and distribute!