Awesome REA
中文Star on GitHubStar1.1k stars
Star on GitHubStar1.1k stars

Tool

shuji

Command-line tool that writes the original JavaScript and CSS sources embedded in source maps back out as files. It reads .map files, or JavaScript and CSS files whose sourceMappingURL holds an inline Base64 or URL-encoded map or points to a map in the same folder, and can walk directories with a regular-expression filter. Output is flattened to file names by default, or keeps the map's folder structure with --preserve.

Targets
Website
Category
Website analysis tools
Relationship
Foundation tool
Sources reviewed

Requirements & limits

  • npm release at review: shuji 0.8.0, published 2023-12-04, which requires Node.js 14.15.0+; the repository publishes tags but no GitHub releases. The reviewed main commit is 139 commits ahead and unreleased: it raises the minimum to Node.js 24.12.0, which the README already states, moves linting to Oxlint and, since 2026-10-11, rejects output paths that would escape the output directory.
  • Install the CLI globally with npm and run it on a file or directory with -o for the output directory; the default filter only picks .map files, so -M is needed to scan .js or .css files for inline maps. Maps are read from local files only: a referenced map must sit relative to the code file, and remote maps are not fetched.
  • Only sources whose content is embedded in the map's sourcesContent are written; entries that list a path without content are skipped, so maps built without included sources yield nothing for them. Existing files are never overwritten, so flattened sources with the same file name are skipped unless --preserve is used.
  • MIT. Recovered files remain the original authors' code under their own terms.

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

  1. README.md GitHub · paazmaya/shuji · Revision a97c6df
  2. package.json GitHub · paazmaya/shuji · Revision a97c6df
  3. CHANGELOG.md GitHub · paazmaya/shuji · Revision a97c6df
  4. lib/find-map.js GitHub · paazmaya/shuji · Revision a97c6df
  5. lib/read-sources.js GitHub · paazmaya/shuji · Revision a97c6df
  6. lib/write-sources.js GitHub · paazmaya/shuji · Revision a97c6df
  7. LICENSE GitHub · paazmaya/shuji · Revision a97c6df
  8. https://www.npmjs.com/package/shuji/v/0.8.0

More in Websites

All 61 entries in Websites

↑↓ move↵ open⌘↵ new tab