back
loading skill details...
Removes platform-specific artifacts from Replit, StackBlitz, CodeSandbox, Glitch. Use when preparing exported projects for production.
Paths: File paths (references/, ../ln-*) are relative to this skill directory.
ln-724-artifact-cleaner
Type: L3 Worker
Category: 7XX Project Bootstrap
Removes platform-specific artifacts from projects exported from online platforms, preparing them for production deployment.
Overview
Aspect
Details
Input
Project directory, platform (auto-detect or manual)
Output
Clean project without platform dependencies
Platforms
Replit, StackBlitz, CodeSandbox, Glitch
Duration
~2-5 minutes
Invocation
Called from ln-720 (TRANSFORM mode, conditional) or user-invocable
Invocation conditions:
TRANSFORM mode only (SKIP in CREATE mode)
At least one platform detected
User confirmation before cleanup
Platform Support Matrix
Platform
Config Files
Directories
NPM Packages
Build Config
Comments
Replit
.replit, replit.nix
.local/, .cache/, .upm/
@replit/*
REPL_ID checks
// @replit
StackBlitz
.stackblitzrc
.turbo/
--
Port overrides
--
CodeSandbox
sandbox.config.json
.codesandbox/
--
CSB env checks
--
Glitch
glitch.json, .glitch-assets
.glitch/, .data/
--
Glitch env vars
--
Reference: platform_artifacts.md
Workflow
Phase 1: Detect & Scan
|
+---> 1.0 Detect platforms (auto-detect by config files)
+---> 1.1 Scan platform-specific artifacts
|
v
Phase 2: Preview
|
v
Phase 3: Confirm
|
v
Phase 4: Execute (per detected platform)
|
+---> 4.1 Delete files/directories
+---> 4.2 Modify package.json
+---> 4.3 Modify build config (vite/webpack)
+---> 4.4 Remove platform comments
+---> 4.5 Modify .gitignore
|
v
Phase 5: Verify & Report
Phase 1: Detect & Scan
Step 1.0: Platform Detection
Platform
Primary Indicator
Confidence
Replit
.replit file
100%
StackBlitz
.stackblitzrc
100%
CodeSandbox
sandbox.config.json
100%
Glitch
glitch.json
100%
Output:
Detected Platforms:
- replit (confidence: 100%)
Step 1.1: Scan Artifacts
Per detected platform, scan for artifacts using platform-specific detection rules.
Replit 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
StackBlitz/CodeSandbox/Glitch: MANDATORY READ: Load platform_artifacts.md for detection rules.
Scan Output Format
Scan Results:
Platform: Replit
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
Build 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 per platform.
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
- 2 UI files: Remove 10 @replit comments
- .gitignore: Remove ".replit" line
Summary: 2 files deleted, 1 directory deleted, 5 files modified
Phase 3: Confirm
Proceed with platform cleanup (Replit)? [Y/n]
Options:
Y (default): Execute cleanup
n: Cancel operation
Custom exclusions: User can specify files to skip
Phase 4: Execute
Platform Router
Based on detected platforms, dispatch to platform-specific cleanup. Execute sequentially if multiple platforms detected.
4.1 Replit Cleanup (Primary)
Delete files/directories:
rm -f .replit replit.nix .replit.nix
rm -f vite-plugin-meta-images.ts
rm -rf .local/ .cache/ .upm/ .breakpoints
Modify package.json: Remove keys starting with @replit/ from devDependencies.
Modify vite.config.ts:
Remove @replit/* imports
Remove Replit plugins from plugins array
Remove REPL_ID conditional blocks
Remove // @replit comments: Grep // @replit.*$ in **/*.tsx, **/*.ts, **/*.jsx, **/*.js.
Modify .gitignore: Remove .replit line.
4.2 StackBlitz Cleanup
rm -f .stackblitzrc
rm -rf .turbo/ # Only if not used in production
4.3 CodeSandbox Cleanup
rm -f sandbox.config.json
rm -rf .codesandbox/
Remove "sandbox" field from package.json (if exists).
4.4 Glitch Cleanup
rm -f glitch.json .glitch-assets
rm -rf .glitch/
# .data/ - ASK USER before deleting (may contain important data)
Remove Glitch env var checks (PROJECT_DOMAIN, ASSETS_URL) from server code.
Phase 5: Verify & Report
Cleanup Complete!
Platforms Cleaned: Replit
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 platform artifacts"
Edge Cases
Case
Handling
No platform artifacts found
Report "Project is clean" and exit
Multiple platforms detected
Clean each sequentially, separate reports
Project uses Webpack (not Vite)
Search webpack.config.* instead
No package.json
Skip NPM cleanup phase
.data/ directory (Glitch)
Ask user before deleting (may contain data)
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
Build config syntax error
Log error, suggest manual fix
Integration
With ln-720-structure-migrator
Called conditionally in TRANSFORM mode:
ln-720-structure-migrator:
Phase 1: Detect project type + platform
Phase 2: Clean artifacts (ln-724-artifact-cleaner) # CONDITIONAL
Condition: Platform detected (Replit/StackBlitz/CodeSandbox/Glitch)
Skipped if: CREATE mode OR no platform markers
Phase 3: Restructure frontend (ln-721)
Phase 4: Generate backend (ln-722)
Phase 5: Generate seed data (ln-723)
Standalone Usage
User: Clean my project from platform artifacts
Claude: Invokes ln-724-artifact-cleaner
Critical Rules
Conditional Invocation: Only run when platform artifacts detected, SKIP in CREATE mode
User Confirmation: Always preview and confirm before deleting
No Data Loss: Ask user before deleting directories that may contain user data (.data/)
Build Verification: Recommend npm run build after cleanup
Idempotent: Re-running on clean project reports "no artifacts found"
References
platform_artifacts.md - Per-platform artifact catalog
Definition of Done
At least one platform detected (Replit/StackBlitz/CodeSandbox/Glitch)
All platform artifacts scanned and previewed to user
User confirmation received before any deletions
Platform files, directories, dependencies, build config, and comments cleaned
.gitignore entries for platform files removed
Cleanup report generated with deleted/modified file counts
Version: 2.0.0
Last Updated: 2026-02-07don't have the plugin yet? install it then click "run inline in claude" again.