Troubleshooting
Hub for diagnosing CLI, test, workflow, feed, and docs build issues in ai-web-feeds
Source: apps/web/content/docs/guides/troubleshooting.mdx
Troubleshooting
Use this page to route common problems to the right guide. Each link points to an existing troubleshooting section in the docs site.
Where to look
CLI commands
Command reference, flags, and CLI-specific failure modes.
CLI workflows
How CLI commands fit into validation, export, and enrichment pipelines.
Tests
pytest paths, coverage, markers, and `ai-web-feeds test` debugging.
GitHub workflows
CI job failures, workflow triggers, and automation integration.
Development workflows
Repository automation, scheduled jobs, and maintainer workflows.
Feed schema
YAML structure, validation errors, and feed metadata rules.
GitHub infrastructure
Issue templates, labels, and repository automation assets.
Web and docs build
Next.js cache, TypeScript errors, and Fumadocs configuration checks.
Getting started
First-run setup, environment issues, and onboarding fixes.
Still stuck?
Open a bug report with reproduction steps, command output, and the doc section you already tried.