Drivers
GitHub
Map files from a remote GitHub repository (readonly).
Usage
Driver name: github
This driver fetches all possible keys once and keep it in cache for 10 minutes. Due to GitHub rate limit, it is highly recommended to provide a token. It only applies to fetching keys.
import { createStorage } from "unstorage";
import githubDriver from "unstorage/drivers/github";
const storage = createStorage({
driver: githubDriver({
repo: "nuxt/nuxt",
branch: "main",
dir: "/docs",
}),
});
Options:
repo
: GitHub repository. Format isusername/repo
ororg/repo
(required)token
: GitHub API token. (recommended)branch
: Target branch. Default ismain
dir
: Use a directory as driver root.ttl
: Filenames cache revalidate time. Default is600
seconds (10 minutes)apiURL
: GitHub API domain. Default ishttps://api.github.com
cdnURL
: GitHub RAW CDN Url. Default ishttps://raw.githubusercontent.com