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/repoororg/repo(required)token: GitHub API token. (recommended)branch: Target branch. Default ismaindir: Use a directory as driver root.ttl: Filenames cache revalidate time. Default is600seconds (10 minutes)apiURL: GitHub API domain. Default ishttps://api.github.comcdnURL: GitHub RAW CDN Url. Default ishttps://raw.githubusercontent.com