Skip to content

Victus0660/JrTimer---Web-Based-Rubik-s-Cube-Speedcubing-Timer

Repository files navigation

⏱️ JrTimer

License: AGPL v3 PRs Welcome Live Demo

A professional, lightning-fast Rubik's Cube and speedcubing timer built for the modern web. Practice your solves with official WCA scrambles, track your session statistics, and visualize cube states in real-time 3D.

Free · No account required · Works offline · Supports all WCA events


✨ Key Features

  • 🏆 Official WCA Scrambles: Support for all official events (2x2, 3x3, 4x4, 5x5, 6x6, 7x7, Megaminx, Pyraminx, Skewb, Square-1, and Clock).
  • 📊 Advanced Analytics: Real-time Ao5, Ao12, Ao50, Ao100, session mean, and personal best (PB) tracking.
  • 🎤 Stackmat Hardware Integration: Connect your Stackmat timer directly to your browser via microphone input.
  • 📱 PWA & Offline Support: Installable as a Progressive Web App. Works flawlessly on desktop and mobile without an internet connection.
  • 🔒 Privacy First: All solve data is stored locally on your device via IndexedDB. Your data never leaves your browser.
  • 🎨 Premium Visuals: Beautiful dark mode and multiple customizable themes (Sakura, Ocean, Sunset, Forest, Neon City).
  • 🗣️ WCA Inspection: 15-second inspection countdown with standard WCA voice alerts (8s, 12s).
  • 🌐 Multi-Language: English, 繁體中文, 日本語, 한국어, Español, Deutsch, Français.

🚀 Deployment

JrTimer is a purely static front-end application (HTML/CSS/JS). There is no backend server required, making it incredibly easy and free to host.

Quick Deploy

You can deploy this project instantly to any static hosting service:

  • Cloudflare Pages (Recommended)
  • Vercel
  • Netlify
  • GitHub Pages

Manual Setup

  1. Clone the repository:
    git clone https://github.com/Victus0660/JrTimer.git
  2. Serve the directory locally using any static server:
    npx serve .
    Or simply open index.html in your browser.

🛠️ Technology Stack

  • Core: Vanilla JavaScript (ES6+), HTML5, CSS3
  • Styling: Tailwind CSS
  • Storage: IndexedDB (via local wrapper)
  • Charts: Chart.js
  • Visualization: Custom 3D CSS rendering engine

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check out the issues page.

If you want to contribute, please read our CONTRIBUTING.md for guidelines.


📜 License

This project is open-source and licensed under the GNU Affero General Public License v3.0 (AGPLv3).

Under the AGPLv3:

  • You are free to use, modify, and distribute this software.
  • IMPORTANT: If you modify this software and provide access to it over a network (e.g., hosting it on a website), you MUST offer the complete source code of your modified version under the exact same AGPLv3 license.

See the LICENSE file for the full legal text.

About

A professional web-based Rubik's Cube and speedcubing timer with official WCA scrambles and Stackmat support.

Topics

Resources

License

Code of conduct

Contributing

Stars

1 star

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors