---
title: "Shared Removal Loop"
description: "Learn the loop that every feature removal guide builds on, from deleting entry points to a green build."
canonical_url: "https://www.vuesion.dev/docs/removal/shared-removal-loop"
---

> Index of every page on this site: [llms.txt](https://www.vuesion.dev/llms.txt)

# Shared Removal Loop

Vuesion is a foundation, not a finished product. Every guide in this section lists what to delete to remove one optional feature. No refactoring is needed.

Removal guides never change Vuesion itself. They only describe what you delete in your own project.

## Before you start

Work on a branch.

The baseline must be green: `npm run lint`, `npm test` and `npm run build` pass before you delete anything. Otherwise you cannot tell your own errors from existing ones.

## The loop

1. Delete the entry points listed in the guide.
2. Run `npm run lint:code`. Fix every reported error by deleting the dead reference.
3. Handle everything under "Not found by the compiler" in the guide: runtime config strings, env variables, i18n keys, Prisma schema and migrations, and docs links. The i18n extractor (`npm run extract-i18n-messages`) only adds keys and never removes unused ones, so delete them by hand from the files in `i18n/locales`, including the `-server` files.
4. Run `npm test`. The 100% coverage threshold exposes code that became dead. Delete it and its tests, and never lower thresholds.
5. Run `npm run build`.
6. Repeat until lint, test and build pass.

## Database

Removing a Prisma model needs a new migration. Create it with `npm run db:migrate`.

Never edit or delete existing migrations. A database reset needs your explicit confirmation.

## Anatomy of a guide

Every guide has three sections.

- **Entry points** lists the files, directories, env variables, config keys and other starting points to delete. A test in the repository verifies that every listed path exists.
- **Not found by the compiler** lists the references that lint, tests and build do not report. You find these by hand.
- **Coding-agent prompt** holds a ready-made prompt for a coding agent.

## Using a coding agent

Each guide ends with a prompt. Give the agent the guide and this page, and let it run the loop.

## Sitemap

See the full [sitemap](https://www.vuesion.dev/sitemap.md) for all pages.