scholarr/README.md

42 lines
1.7 KiB
Markdown

# Scholarr
Scholarr is a self-hosted author watchlist and publication tracker. Follow researchers, learn
when they publish, and find legal open-access copies of their work.
The rewrite is pre-alpha. [SPRINT.md](SPRINT.md) is the single reference for its
proposed integrated product sprint; preparation does not authorize a launch.
## Non-negotiable rule
Scholarr never makes network requests to Google Scholar or any other Google endpoint. Imported
Scholar IDs and URLs are inert metadata and human-clickable links only. Publication data comes
from documented APIs such as OpenAlex, Crossref, arXiv, Unpaywall, and ORCID.
## Technical direction
- Go backend
- Vue frontend
- SQLite only
- Multi-user, with a globally deduplicated publication store and per-user follow/read state
- Internal auth, generic OIDC, and trusted-header auth in v1
- Config-driven operation and simple first-run onboarding
Read [SPRINT.md](SPRINT.md) for scope, decisions, provider safety, and acceptance.
[AGENTS.md](AGENTS.md) supplies the repository constraints.
## Repositories
- Primary: <https://github.com/JustinZeus/scholarr>
- Forgejo tracker and sprint delivery: <https://git.justinvisser.org/justinzeus/scholarr>
- Preserved legacy implementation: <https://github.com/JustinZeus/scholarr-legacy>
## Frozen interface contract
The reviewed interface contract is in [design/DESIGN.md](design/DESIGN.md). Its tokens, component
reference, icons, logos, favicons, and proof implementation are checked in beside it. These files
are the source for the Vue port, not an application implementation.
## License
The sprint proposes MIT, subject to owner approval of [SPRINT.md](SPRINT.md).
Until a LICENSE file is added, normal copyright rules apply.