This is a Next.js project bootstrapped with create-next-app.
Use Node.js 24 LTS. With nvm, install and select the project version, then install dependencies:
nvm install
nvm use
npm ciRun npm test for the API tests and npm run build for a production build.
Configure hosted builds to use Node.js 24 as well.
First, run the development server:
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun devOpen http://localhost:3000 with your browser to see the result.
You can start editing the page by modifying app/page.js. The page auto-updates as you edit the file.
This project uses next/font to automatically optimize and load Inter, a custom Google Font.
To learn more about Next.js, take a look at the following resources:
- Next.js Documentation - learn about Next.js features and API.
- Learn Next.js - an interactive Next.js tutorial.
You can check out the Next.js GitHub repository - your feedback and contributions are welcome!
Set API_KEY in the Vercel project's environment variables for Production
(and Preview if you use preview deployments). Use your direct API-Sports key.
Jolt sends it to v1.american-football.api-sports.io using x-apisports-key;
a RapidAPI subscription key is not interchangeable.
Keep the name API_KEY. Do not use NEXT_PUBLIC_API_KEY or add the key to
next.config.mjs: the credential must stay on the server.
Redeploy after adding or changing the variable. Existing Vercel deployments do not receive updated environment variables. Data pages use the Node.js runtime and render per request, while API responses retain their explicit cache periods.
If data still fails, inspect Vercel function logs for [Jolt API]:
- Missing
API_KEY: check the variable's deployment environment and redeploy. - HTTP 401/403 or
authentication: check that the direct API-Sports key is valid. quotaorplan: check the provider allowance and season access.
Jolt defaults to seasons 2022–2024, the range confirmed by this account's
free-plan error. It selects the latest accessible season (2024) and filters the
season menus to that range. Published league seasons do not prove plan access.
If your subscription or its allowed years change, set server environment variables
API_MIN_SEASON and API_MAX_SEASON to the allowed bounds, then redeploy.
These bounds restrict historical links as well as automatic selection.
Diagnostics never print the credential or raw provider error messages.
References: Vercel environment variables, Next.js server environment variables.