https://github.com/napo/openvolleyscout
Open-source React web application for volleyball scouting and match analysis.
https://github.com/napo/openvolleyscout
scouting scouting-app volleyball
Last synced: 2 days ago
JSON representation
Open-source React web application for volleyball scouting and match analysis.
- Host: GitHub
- URL: https://github.com/napo/openvolleyscout
- Owner: napo
- License: gpl-3.0
- Created: 2026-04-18T20:01:46.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-25T08:10:27.000Z (7 days ago)
- Last Synced: 2026-05-25T08:24:13.430Z (7 days ago)
- Topics: scouting, scouting-app, volleyball
- Language: TypeScript
- Homepage: https://napo.github.io/openvolleyscout/
- Size: 18.8 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# OpenVolleyScout
Analyze. Scout. Improve.
OpenVolleyScout is a local-first web application for volleyball match setup,
scouting, tactical-system editing, and early match reporting.
The application runs entirely in the browser. Match projects, team archives,
rosters, and competition names are persisted on the device with IndexedDB.
Locale and defense-system editor state are stored in `localStorage`.
Live demo: https://napo.github.io/openvolleyscout
> The project is under active development. Some workflows are complete enough
> to use as foundations, while analysis and advanced tactical automation are
> still evolving.
## Current Capabilities
- Create and manage archived teams and rosters.
- Create match projects from competition metadata, selected teams, and
match-specific rosters.
- Configure match-level scouting settings such as set targets and tie-break
targets.
- Start sets from selected lineups and serving team.
- Record rally events, touches, points, score corrections, set endings, and
match endings through an event log.
- Persist scouting progress back into the active `MatchProject`.
- Generate live quick stats, set summaries, rally summaries, and DataVolley-like
rally strings from recorded events.
- Edit and persist a simple defense-system layout in the browser.
## Technical Stack
- React 18
- TypeScript
- Vite
- React Router
- Zustand
- Dexie / IndexedDB
## Local Development
Install dependencies:
```bash
npm install
```
Start the development server:
```bash
npm run dev
```
Build for production:
```bash
npm run build
```
Preview a production build:
```bash
npm run preview
```
Run the current validation script:
```bash
npm test
```
`npm test` currently runs `scripts/validate-match-stats.mjs`, which bundles and
executes the match-statistics fixture validation.
## Main Application Routes
The app uses hash routing, so routes are rendered under `#/...`.
- `#/` - landing page
- `#/teams` - archived team and roster management
- `#/match` - match setup workflow
- `#/scouting` - live scouting workflow
- `#/systems` - defense-system editor
- `#/analysis` - placeholder for future analysis views
- `#/load-data` - saved match project loading
- `#/settings` - locale and local-data actions
- `#/about` - project information
## Documentation
Start with [docs/README.md](docs/README.md).
Important entry points:
- [Architecture](docs/architecture.md)
- [Data Model](docs/data-model.md)
- [Domain Model](docs/domain-model.md)
- [Persistence](docs/persistence.md)
- [Scouting Architecture](docs/scouting.md)
- [Tactical Systems](docs/systems.md)
- [Code Structure](docs/code-structure.md)
- [Developer Guidelines](docs/developer-guidelines.md)
## Project Status
Implemented foundations:
- local match and archive persistence
- match creation and readiness validation
- event-sourced scouting session replay
- scouting persistence into `MatchProject.events` and `MatchProject.scoutingSession`
- match statistics builder and validation fixture
- simple defense-system editor backed by `localStorage`
- English and Italian UI translations with persisted locale choice
Still in progress:
- full DataVolley export compatibility
- advanced player suggestion from tactical systems
- persistent tactical-system repository in IndexedDB
- full analysis screens
- broader automated test coverage
## Preview
