ln-724-replit-cleaner

| Aspect | Details |

|--------|---------|

| Input | Project directory (Replit export) |

| Output | Clean project without Replit dependencies |

| Duration | ~2-5 minutes |

| Invocation | Called from ln-720-structure-migrator or user-invocable |

---

| Category | Artifacts | Action |

|----------|-----------|--------|

| Config Files | .replit, replit.nix, .replit.nix | DELETE |

| Directories | .local/, .cache/, .upm/, .breakpoints | DELETE |

| NPM Packages | @replit/vite-plugin-* | REMOVE from package.json |

| Vite Config | Imports, plugins, REPL_ID checks | MODIFY vite.config.ts |

| Custom Plugins | vite-plugin-meta-images.ts (Replit-specific) | DELETE |

| Code Comments | // @replit annotations | REMOVE |

| .gitignore | .replit entry | REMOVE line |

---

```

Phase 1: Scan

|

v

Phase 2: Preview

|

v

Phase 3: Confirm

|

v

Phase 4: Execute

|

+---> 4.1 Delete files/directories

+---> 4.2 Modify package.json

+---> 4.3 Modify vite.config.ts

+---> 4.4 Remove @replit comments

+---> 4.5 Modify .gitignore

|

v

Phase 5: Verify & Report

```

---

Detect all Replit artifacts in the project.

Detection Rules

```yaml

Files:

- Glob: .replit, replit.nix, .replit.nix

- Glob: vite-plugin-meta-images.ts (if uses REPLIT_* env vars)

Directories:

- Glob: .local/, .cache/, .upm/, .breakpoints

Package.json:

- Grep: "@replit/" in devDependencies

Vite Config:

- Grep: "@replit/" imports

- Grep: "REPL_ID" or "REPLIT_" environment checks

Code:

- Grep: "// @replit" comments in .tsx, .ts, .jsx, .js

.gitignore:

- Grep: "^\.replit$" line

```

Output Format

```yaml

Scan Results:

Files Found: 2

- .replit (729 bytes)

- vite-plugin-meta-images.ts (2333 bytes)

Directories Found: 1

- .local/ (6 files, 589KB)

Package Dependencies: 3

- @replit/vite-plugin-cartographer

- @replit/vite-plugin-dev-banner

- @replit/vite-plugin-runtime-error-modal

Vite Config Modifications: 4

- Import: runtimeErrorOverlay

- Import: metaImagesPlugin

- Plugin: runtimeErrorOverlay()

- Block: REPL_ID conditional (lines 14-24)

Code Comments: 10

- button.tsx: 5 comments

- badge.tsx: 5 comments

Gitignore Entries: 1

- .replit

```

---

Show detailed preview of changes.

```yaml

Will DELETE files:

- .replit (729 bytes)

- vite-plugin-meta-images.ts (2333 bytes)

Will DELETE directories:

- .local/ (6 files, 589KB)

Will MODIFY files:

- package.json: Remove 3 @replit/* devDependencies

- vite.config.ts: Remove 4 imports/plugins/blocks

- client/src/components/ui/button.tsx: Remove 5 @replit comments

- client/src/components/ui/badge.tsx: Remove 5 @replit comments

- .gitignore: Remove ".replit" line

Summary: 2 files deleted, 1 directory deleted, 5 files modified

```

---

Request user confirmation before making changes.

```

Proceed with Replit cleanup? [Y/n]

```

Options:

• Y (default): Execute cleanup
• n: Cancel operation
• Custom exclusions: User can specify files to skip

---

4.1 Delete Files and Directories

```bash

# Delete config files

rm -f .replit replit.nix .replit.nix

# Delete Replit-specific plugin

rm -f vite-plugin-meta-images.ts

# Delete Replit directories

rm -rf .local/ .cache/ .upm/ .breakpoints

```

4.2 Modify package.json

Remove from devDependencies:

```json

{

"devDependencies": {

"@replit/vite-plugin-cartographer": "^0.4.4",

"@replit/vite-plugin-dev-banner": "^0.1.1",

"@replit/vite-plugin-runtime-error-modal": "^0.0.4"

}

}

```

Method: JSON parse, filter keys starting with @replit/, serialize.

4.3 Modify vite.config.ts

Remove imports:

```typescript

// REMOVE

import runtimeErrorOverlay from "@replit/vite-plugin-runtime-error-modal";

import { metaImagesPlugin } from "./vite-plugin-meta-images";

```

Remove from plugins array:

```typescript

// REMOVE

runtimeErrorOverlay(),

metaImagesPlugin(),

```

Remove REPL_ID conditional block:

```typescript

// REMOVE entire block

...(process.env.NODE_ENV !== "production" &&

process.env.REPL_ID !== undefined

? [

await import("@replit/vite-plugin-cartographer").then((m) =>

m.cartographer(),

),

await import("@replit/vite-plugin-dev-banner").then((m) =>

m.devBanner(),

),

]

: []),

```

4.4 Remove @replit Comments

Pattern: // @replit.*$

Files: */.tsx, */.ts, */.jsx, */.js

Method: Read file, remove lines containing // @replit, preserve indentation and structure.

4.5 Modify .gitignore

Remove line: .replit

---

Final Report

```yaml

Cleanup Complete!

Deleted:

- .replit

- vite-plugin-meta-images.ts

- .local/ (6 files)

Modified:

- package.json (removed 3 dependencies)

- vite.config.ts (removed 4 imports/plugins)

- button.tsx (removed 5 comments)

- badge.tsx (removed 5 comments)

- .gitignore (removed 1 line)

Next Steps:

1. Run npm install to update package-lock.json

2. Run npm run build to verify build works

3. Commit: git add . && git commit -m "chore: remove Replit artifacts"

```

---

| Case | Handling |

|------|----------|

| No Replit artifacts found | Report "Project is clean" and exit |

| Project uses Webpack (not Vite) | Search webpack.config.* instead |

| Project uses other bundlers | Search common config patterns |

| No package.json | Skip NPM cleanup phase |

| Protected files | Ask user before modifying |

---

| Error | Action |

|-------|--------|

| Permission denied | Log error, suggest chmod or admin rights |

| File in use | Retry after delay, then warn user |

| JSON parse error | Log error, suggest manual fix |

| Vite config syntax error | Log error, suggest manual fix |

---

With ln-720-structure-migrator

Called as first step before restructuring:

```yaml

ln-720-structure-migrator:

Phase 1: Detect project type

Phase 2: Clean Replit artifacts (ln-724-replit-cleaner) # THIS SKILL

Phase 3: Restructure frontend (ln-721)

Phase 4: Generate backend (ln-722)

Phase 5: Migrate mock data (ln-723)

```

Standalone Usage

```

User: Clean my project from Replit

Claude: Invokes ln-724-replit-cleaner

```

---

• [replit_artifacts.md](references/replit_artifacts.md) - Complete artifact list by category

---

Version: 1.0.0

Last Updated: 2026-01-10