ln-724-replit-cleaner

Type: L3 Worker Category: 7XX Project Bootstrap Parent: ln-720-structure-migrator

Completely removes Replit-specific artifacts from projects exported from Replit, preparing them for production deployment elsewhere.

---

Overview

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

---

Artifacts Removed

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

---

Workflow

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

---

Phase 1: Scan

Detect all Replit artifacts in the project.

Detection Rules

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

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

---

Phase 2: Preview

Show detailed preview of changes.

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

---

Phase 3: Confirm

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

---

Phase 4: Execute

4.1 Delete Files and Directories

# 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:

{
  "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:

// REMOVE
import runtimeErrorOverlay from "@replit/vite-plugin-runtime-error-modal";
import { metaImagesPlugin } from "./vite-plugin-meta-images";

Remove from plugins array:

// REMOVE
runtimeErrorOverlay(),
metaImagesPlugin(),

Remove REPL_ID conditional block:

// 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

---

Phase 5: Verify & Report

Final Report

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"

---

Edge Cases

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 Handling

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

---

Integration

With ln-720-structure-migrator

Called as first step before restructuring:

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

---

References

• replit_artifacts.md - Complete artifact list by category

---

Version: 1.0.0 Last Updated: 2026-01-10