0
/ 100
Good shape overall. A few tweaks would push it into the top tier.
Basis is an open-source social framework for VR and Desktop usage.
Top fixes
Highest-impact changes first, ranked by point weight
- 1Tests18pt
Wire your tests to a documented command (e.g. a test script in your build config) so the suite is reproducible.
- 2CI/CD14pt
Add a step like `run: npm test`, `run: pytest`, or `run: tox` to your workflow file.
- 3CI/CD14pt
Add a lint step to catch style issues automatically.
- 4CI/CD14pt
Add `tsc --noEmit`, `mypy`, or `cargo check` to catch type errors before they merge.
Working through the fixes? Let every push regrade itself.
The free GitHub App rescans this repo on every push and posts the grade as a commit check, so the score climbs without coming back to rescan by hand.
Scorecard
Every check, grouped by category and sorted worst-first
Documentation
89
Contributing guide is detailed and thorough.
README is present.
README documents how to install the project.
Licensed under Other.
Engineering
69
No dependency lockfile found (−70 pts).
→ Enable and commit packages.lock.json so NuGet restores are repeatable.
CI is configured (.github/workflows/build-docker-server.yml).
Test files detected (Basis Server/BasisRestApi.Tests/RestApiTests.cs).
.NET formatting configured (.editorconfig).
Issue or PR templates present.
Project health
100
Dependency manifest found (Basis Server/Basis Server.sln).
Repository has a description.
Actively maintained (pushed within the last month).
.gitignore present.
Repository health signals
Activity, community, and responsiveness at scan time
Activity
- -Commits (30d / 90d)
- 138Forks
- 8Releaseslatest 1mo ago
Community
- -Community health
- -authors own >50% of commits
- 450Watchers
Responsiveness
- 3dMedian issue response
- <1hMedian PR merge time
- 58Open issues
Repository files18 root entries
- .config
- .githubGood: CI is configured (.github/workflows/build-docker-server.yml).Good: Environment pinned via .github/docker/headless/linux/Dockerfile.Good: Issue or PR templates present.
- BasisGood: Licensed under Other.Good: Contributing guide is detailed and thorough.Issue: Contributing guide lacks a setup section (−12 pts).Fix: Show new contributors how to get a local dev environment running.Issue: Contributing guide lacks a code style section (−8 pts).Fix: Describe your linting/formatting rules and how to run them.Issue: Contributing guide lacks a testing section (−8 pts).Fix: Show contributors how to run the test suite (e.g. npm test, pytest, cargo test).Good: Contributing guide describes the PR/review workflow.Good: Contributing guide includes code examples.
- Basis ServerGood: Test files detected (Basis Server/BasisRestApi.Tests/RestApiTests.cs).Good: Dependency manifest found (Basis Server/Basis Server.sln).
- tools
- .csharpierignore
- .editorconfigGood: .NET formatting configured (.editorconfig).
- .gitattributes
- .gitignoreGood: .gitignore present.
- CI.md
- CONTRIBUTING.md
- Directory.build.props
- ExportSourceFiles.ps1
- LICENSE
- PHILOSOPHY.md
- README.mdGood: README is present.Good: README is well structured with multiple sections.Good: README includes screenshots or visuals. Great for first impressions.Good: README has code examples.Good: README links to a live demo or deployed app.Issue: No status badges in the README (−10 pts).Fix: Add CI/build status badges from shields.io or your CI provider to signal project health.Good: README documents how to install the project.Good: README documents how to run the project.
- STYLE.md
- TRADEMARK.md
Add this badge to your README
It updates automatically each time the repo is re-graded.
[](https://www.repo-grade.com/report/basisvr/basis)