Research software · R package
Use your team’s colours.
I built colorr to put team colours into R figures. Choose a palette, then use its hex codes or add a scale to your ggplot.
Initial versions: entirely human-created. AI was used only for later updates and code fixes.
Quick start
# Install the development version for the expanded league coverage.
install.packages("remotes")
remotes::install_github("lobsterbush/colorr")
library(colorr)
nba.colors("bucks")
soccer.colors("bayern_munich")
colorr.teams("wnba")The CRAN release is available with install.packages("colorr"). This site documents the development version; its league coverage can be newer than CRAN.
From palette to plot
library(ggplot2)
ggplot(mtcars, aes(factor(cyl), mpg, fill = factor(cyl))) +
geom_boxplot() +
scale_fill_nba("bucks")Use a team palette directly as a named vector of hex colours, or add a colour or fill scale to a ggplot. Set discrete = FALSE for continuous scales.
| Task | Function |
|---|---|
| Discover supported leagues | colorr.leagues() |
| Find team names and keys | colorr.teams() |
| Select a palette by league and team | colorr.colors() |
| Create a palette function | colorr.pal() |
Keep earlier figures reproducible
League palette functions accept legacy = TRUE to return the palettes from colorr 1.0.1. For example, epl.colors("man_united", legacy = TRUE) selects the older palette. See the reference for aliases and supported leagues.
Provenance
Human – AI (editor) 👤✏️🤖
I wrote every initial version myself, without AI. I’ve used AI only for later updates and code fixes. This is my account of how the package was made.
The label and mark follow The Latent Review’s provenance standard, shared under CC BY 4.0. The software remains MIT licensed.
Help and development
If something isn’t working, please tell me in the issue tracker. The source and README include installation requirements and local documentation build instructions.