fig-folder
v1.3.0
Published
A CLI tool to organize configuration files into a fig/ folder with safe mode option
Maintainers
Readme
🍑 Fig
███ ██
███████ ██ ███
█████ █████ ██ ██
██████ ██ ██ ███ ████ ███
██ ███ ██ ███ ███ ███ ███ ███
██ ███ █████ ███ ███ ██
█ ██ ███ ███ ██ ██ █
██ ███ ███ █ █ ██ ███
███ ██ ███ ██ ██ ██ ██
██ ███ ██ ███ ██ ██ ███
██ ███ ███ ██ ██ ███
██ ██ ██ ██ ██ ██ ██ ██
██ ██ ██ ███ █ ██ ██
██ ██ ██ ██ ███ ███ ██ ██
██ ██ ███ ██ ██ ██ ██ ██
██ ██ ██ ██ ██ ██ ██
██ ███ ██ ██ ██ ██ ██ ██
███ ██ ██ ████ ████ ████ ██
██ ██ ███ ████████ ████████ ███
███ ██ ██████ ████
████████ █████████████ ██████
███████████ ████████████
What is Fig?
Fig is a command-line tool that organizes your project's configuration files into a neat fig/ directory. It automatically categorizes and moves common configuration files like:
- Linting: ESLint configs
- Formatting: Prettier configs
- TypeScript: tsconfig files
- Build Tools: Next.js, Vite, Webpack, Tailwind configs
- Environment: .env files
- Package Managers: lock files
- Git: .gitignore, .gitattributes
- Editor: .editorconfig, VS Code settings
- Testing: Jest, Vitest, Cypress configs
- Documentation: README, LICENSE, etc.
Usage
npm run figSafe Mode (Zero Risk)
For completely safe organization that never moves or modifies your original files:
npm run fig -- --safeThis mode:
- ✅ Never moves files - originals stay in place
- ✅ Never creates symlinks - no permission issues
- ✅ Zero risk of breaking imports - nothing changes in your project
- ✅ Pure organization - just copies files to fig/ for viewing
Features
- 🎨 Beautiful ASCII art display
- 📁 Automatic file categorization
- 📝 Generates organized README
- 🎯 Smart file detection
- ✨ Colored terminal output
How it works
- Scans your project root for configuration files
- Creates a
fig/directory if it doesn't exist - Moves files into the
fig/directory - Generates a categorized README.txt listing all moved files
- Displays a beautiful summary with colored output
Categories
When you run npm run fig, your configuration files will be organized into these categories:
- Linting - Code quality and style enforcement
- Formatting - Code formatting rules
- TypeScript - TypeScript configuration
- Build Tools - Build and bundling configuration
- Environment - Environment variables and settings
- Package Managers - Dependency lock files
- Git - Version control configuration
- Editor - Editor-specific settings
- Testing - Test framework configuration
- Documentation - Project documentation files
Enjoy your Figs! 🍑
