Help us help you! Providing a minimal reproduction is one of the best ways for our team to verify and address your issue.
What is a “Minimal Reproduction”?
A minimal reproduction is a simplified code environment created specifically to demonstrate a bug or configuration issue. It contains only the code and configuration required to trigger the problem you are seeing on Netlify.
Why do I need one?
When you reach out for help on the Netlify Forums or contact Netlify Support directly, Support Engineers and community members cannot see your private repositories. Community and Team members can only see and help debug what is publicly available.
A minimal reproduction:
- Isolates the issue: determines whether the issue is with the Netlify platform/environment or with specific logic in your codebase.
- Protects your privacy: It lets you share code publicly without exposing proprietary business logic, customer data, or API secrets.
- Fast-tracks a solution: Instead of spending time asking clarifying questions, an engineer can clone your repository, replicate the error immediately, and escalate when needed.
How to Build a Great Repro
- Create a fresh folder or use a “Hello World” starter for your framework (Next.js, Astro, Vite, etc.).
- Add only the specific library, plugin, or configuration that is causing the issue.
- Verify that the site works as expected when running locally without Netlify (e.g
npm run build) - Deploy it to Netlify (or run
ntl buildlocally, if it is a CLI issue) and confirm the error is present.
Checklist Before Sharing
Before sharing your reproduction, please make sure these boxes are checked!
- Is the Git repository set to Public? (Support cannot access private repos).
- Did you remove all code unrelated to the specific error?
- Did you ensure there are no API keys or passwords in the code?
- Does the error actually happen on this new, smaller site?
Following these steps will ensure our team can help you as quickly and effectively as possible.