https://github.com/oekazuma/svelte-vitals
A static code-health checker for SvelteKit — SEO, Performance, Correctness, Security, and Architecture, from source. Not a runtime Web Vitals reporter.
https://github.com/oekazuma/svelte-vitals
ai-agent cli code-quality github-actions mcp meta-tags opengraph performance security seo seo-tools static-analysis svelte sveltekit typescript vite
Last synced: 7 days ago
JSON representation
A static code-health checker for SvelteKit — SEO, Performance, Correctness, Security, and Architecture, from source. Not a runtime Web Vitals reporter.
- Host: GitHub
- URL: https://github.com/oekazuma/svelte-vitals
- Owner: oekazuma
- License: mit
- Created: 2026-06-17T00:40:43.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-07-18T08:40:50.000Z (9 days ago)
- Last Synced: 2026-07-18T10:12:10.768Z (9 days ago)
- Topics: ai-agent, cli, code-quality, github-actions, mcp, meta-tags, opengraph, performance, security, seo, seo-tools, static-analysis, svelte, sveltekit, typescript, vite
- Language: TypeScript
- Homepage: https://oekazuma.github.io/svelte-vitals/
- Size: 7.26 MB
- Stars: 6
- Watchers: 0
- Forks: 0
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
A static code-health checker for SvelteKit — SEO, Performance, Correctness, Security, and Architecture, from source. No browser or headless Chrome required. (Not a runtime Web Vitals reporter, despite the name.)
```bash
npx svelte-vitals@latest
```
📖 **[Documentation](https://oekazuma.github.io/svelte-vitals/)**
> [!WARNING]
> **Pre-1.0 — not recommended for production use yet.** Development is moving fast and aggressively, driven at the maintainer's discretion until `1.0`: APIs, rule IDs, scoring, and output formats can change at any time, including breaking changes between minor releases. Relying on it in critical pipelines is discouraged until `1.0`.
## Categories
Five categories — **SEO**, **Performance**, **Correctness**, **Security**, **Architecture** — each scored independently and rolled into a single weighted **Health** score. → [Health Report](https://oekazuma.github.io/svelte-vitals/guides/health-report/)
## Features
- **Multiple reporters** — `console`, `json`, `agent` (a Markdown remediation document an AI agent can act on directly), `sarif`, `github`, `md` (a plain Markdown report), and `html` (a self-contained, shareable report). The `agent` reporter auto-selects inside AI-agent harnesses (e.g. Claude Code); `github` auto-selects under GitHub Actions. → [Reporters](https://oekazuma.github.io/svelte-vitals/guides/reporters/)
- **GitHub integration** — zero-config inline PR annotations, plus SARIF upload for persistent code-scanning alerts in the Security tab; `svelte-vitals ci install` scaffolds a full GitHub Actions workflow around `@svelte-vitals/action`, with a job summary and a sticky PR comment. → [Reporters](https://oekazuma.github.io/svelte-vitals/guides/reporters/), [CI integration](https://oekazuma.github.io/svelte-vitals/guides/ci/)
- **Live dashboard** — a searchable, filterable dashboard at `/__svelte-vitals/` during `vite dev`, on by default: whole-project coverage from startup, refined to real rendered values as you browse, with a copy-to-clipboard AI-agent prompt on every finding. → [Live dashboard](https://oekazuma.github.io/svelte-vitals/guides/dev-dashboard/)
- **Plugin mode** (`@svelte-vitals/vite`) — build-time analysis of the prerendered ``; library-agnostic and exact. → [Plugin mode](https://oekazuma.github.io/svelte-vitals/guides/plugin-mode/)
- **MCP server** (`@svelte-vitals/mcp`) — `analyze` and `explain_rule` tools for an agent's tool loop. → [MCP server](https://oekazuma.github.io/svelte-vitals/guides/mcp/)
- **Agent Skills** — `/svelte-vitals` and `/improve-svelte` slash-command skills for Claude Code, Cursor, and Codex: rule knowledge up front, plus a project-wide, evidence-ranked improvement roadmap. → [Agent Skills](https://oekazuma.github.io/svelte-vitals/guides/agent-skills/)
## Packages
Three packages you'll use directly — CLI, Vite plugin, MCP server — all built on the shared `@svelte-vitals/core` rule engine. → [Choosing a package](https://oekazuma.github.io/svelte-vitals/guides/choosing-a-package/)
## Getting started
→ [Getting started](https://oekazuma.github.io/svelte-vitals/guides/getting-started/) for installation, your first run, and exit codes for CI gating.
## Contributing
See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup, commands, and the release process.
## License
[MIT](./LICENSE.md) © [Kazuma Oe](https://github.com/oekazuma)