{"id":20978260,"url":"https://github.com/chengadev/shotclock","last_synced_at":"2026-05-02T05:41:06.190Z","repository":{"id":118620800,"uuid":"341043942","full_name":"ChengaDev/shotclock","owner":"ChengaDev","description":"Sweet application for basketball 24 shot clock operating, includes all the rules of FIBA.","archived":false,"fork":false,"pushed_at":"2023-11-19T15:11:08.000Z","size":1264,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-20T06:17:42.155Z","etag":null,"topics":["basketball","fiba","react","shotclock"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ChengaDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-02-22T01:17:48.000Z","updated_at":"2023-11-06T15:47:58.000Z","dependencies_parsed_at":"2023-11-06T14:29:41.544Z","dependency_job_id":"2df1c43f-9f2f-4be7-8077-64a7a6d3381e","html_url":"https://github.com/ChengaDev/shotclock","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChengaDev%2Fshotclock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChengaDev%2Fshotclock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChengaDev%2Fshotclock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChengaDev%2Fshotclock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ChengaDev","download_url":"https://codeload.github.com/ChengaDev/shotclock/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243382783,"owners_count":20282007,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["basketball","fiba","react","shotclock"],"created_at":"2024-11-19T05:04:51.771Z","updated_at":"2026-05-02T05:41:06.186Z","avatar_url":"https://github.com/ChengaDev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ShotClock Pro — Free Online Basketball Shot Clock\n\n**Live at [24shotclock.com](https://www.24shotclock.com)**\n\nA professional-grade basketball shot clock simulator built for referees, coaches, and fans who want to practice officiating or follow a live game. Fully compliant with FIBA rules.\n\n---\n\n## Features\n\n- **24s / 14s resets** — one-tap resets per FIBA rules (backcourt possession → 24s, offensive rebound / frontcourt control → 14s)\n- **Start / Stop** — single tap to freeze or resume the clock\n- **Correction mode** — increment or decrement seconds to match the referee's monitor review decision\n- **Clear** — blank the display during free throws and between periods\n- **Arena video hero** — immersive basketball court background on the home screen\n- **Basketball loader** — DSEG14 digital-font countdown animation on every page transition\n- **Light \u0026 Dark themes** — persisted per device\n- **Fully responsive** — optimised for phones (portrait and landscape), tablets, and desktop\n- **5 languages** — English, Italian, Spanish, French, Greek (auto-routed per URL prefix)\n- **SEO optimised** — structured data (WebSite, WebApplication, FAQPage, HowTo), Open Graph, Twitter cards, canonical URLs\n\n---\n\n## Pages\n\n| Route | Description |\n|---|---|\n| `/` | Landing page with hero, feature overview, and mode cards |\n| `/clock` | The shot clock — full controls |\n| `/play` | Quick-launch page that goes straight to the clock |\n| `/instructions` | Step-by-step operating guide with pro tips |\n| `/fiba-resources` | Links to official FIBA rulebooks and documents |\n| `/faq` | Frequently asked questions |\n| `/about` | About the project and the developer |\n\nNon-English routes are prefixed: `/it/`, `/es/`, `/fr/`, `/el/`.\n\n---\n\n## How to Use\n\nThe best way to practice is to broadcast a game on TV or YouTube and operate the shot clock in real time alongside the referees.\n\n1. **Throw-in / new possession** → Reset 24s, then Start\n2. **Offensive rebound** → Reset 14s (clock keeps running)\n3. **Defensive foul in backcourt** → Stop, Reset 24s\n4. **Defensive foul in frontcourt with ≥14s remaining** → Stop, leave as is\n5. **Defensive foul in frontcourt with \u003c14s remaining** → Stop, Reset 14s\n6. **Free throws** → Clear display; after last FT made, Reset 24s\n7. **Referee monitor review** → Use Correction to adjust seconds\n\n---\n\n## Tech Stack\n\n| | |\n|---|---|\n| Framework | React 18 + TypeScript |\n| Styling | styled-components |\n| Routing | React Router v6 |\n| Animations | react-spring |\n| Hosting | AWS Amplify + CloudFront |\n| Font | DSEG14 (digital clock), Poppins (UI) |\n\n---\n\n## Local Development\n\n```bash\nnpm install\nnpm start          # dev server at localhost:3000\nnpm run build      # production build\nnpm test           # interactive test runner\nnpm test -- --watchAll=false  # single test run\n```\n\n---\n\n## Rules Reference\n\n- [FIBA Official Basketball Rules](https://www.fiba.basketball/rules)\n- [Shot Clock Equipment Rules](https://www.fiba.basketball/rules/equipment)\n\n---\n\nBuilt by [Chen Gazit](https://chengazit.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchengadev%2Fshotclock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchengadev%2Fshotclock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchengadev%2Fshotclock/lists"}