Skip to content

alvaro-freire/devutil-toolkit

DevUtil Toolkit

Professional developer utilities and toolkit collection with interactive CLI and web interface

License: MIT Node Version

✨ Features

  • 🔍 Interactive Search - Find utilities instantly with fuzzy search
  • 🖥️ CLI Tool - Command-line interface for quick access
  • 🌐 Web Interface - Browse utilities with modern, responsive UI
  • 📋 Copy-to-Clipboard - One-click code snippet copying
  • 🏷️ Smart Organization - Categorized and tagged utilities
  • Quality Assured - Validated and tested content
  • 🌙 Dark Mode - Eye-friendly interface
  • 📱 Mobile Ready - Responsive design for all devices

🚀 Quick Start

CLI Installation

# Clone the repository
git clone <repository-url>
cd devutil-toolkit

# Install dependencies
npm install

# Build CLI tool
npm run build:cli

# Link for global usage (optional)
npm link

CLI Usage

# Search utilities
devutil search git

# Interactive mode
devutil interactive

# List by category
devutil list git

# Show specific utility
devutil show ssh-key-setup

# Copy code snippet
devutil show ssh-key-setup --copy

# View all categories
devutil categories

# View all tags
devutil tags

Web Interface

Visit the web interface at [your-vercel-url] or run locally:

cd web
npm install
npm run dev

Then open http://localhost:3000 in your browser.

📚 Content Organization

The utilities are organized into the following categories:

  • Development Tools - Git utilities, programming language tips, mobile development

    • Git (SSH keys, GPG signing, configuration, log formatting)
    • Programming Languages (C, Python, JavaScript, etc.)
    • Mobile Development (Flutter, React Native, Android, iOS)
  • System Administration - Terminal commands, shell configuration, debugging

    • Terminal Commands (File management, networking, text processing)
    • Shell Configuration (Zsh, Bash, aliases, environment)
    • Debugging (Valgrind, GDB, profiling tools)
  • Communication - Platform-specific utilities

    • Discord, Slack, and other communication tools

🛠️ Development

Project Structure

devutil-toolkit/
├── content/                 # Reorganized utilities with metadata
│   ├── development-tools/
│   ├── system-administration/
│   ├── communication/
│   └── _meta/              # Generated metadata files
├── src/                    # CLI tool (TypeScript)
│   ├── cli.ts
│   ├── commands/
│   ├── lib/
│   └── types/
├── web/                    # Next.js web interface
│   ├── app/
│   ├── components/
│   └── lib/
├── scripts/                # Automation & validation
│   ├── migrate-content.js
│   ├── validate-content.js
│   └── generate-metadata.js
├── schemas/                # JSON Schema definitions
└── .github/                # CI/CD workflows

Available Scripts

# CLI Development
npm run cli              # Run CLI with tsx
npm run build:cli        # Build CLI to dist/

# Web Development
npm run dev              # Start Next.js dev server
npm run build:web        # Build Next.js for production

# Content Management
npm run migrate          # Run content migration
npm run validate         # Validate all content

# Code Quality
npm run lint             # Run ESLint
npm run format           # Format with Prettier
npm run test             # Run tests

Adding New Utilities

  1. Create a new markdown file in the appropriate category under content/
  2. Add frontmatter metadata (see template in CONTRIBUTING.md)
  3. Write your utility content with clear instructions
  4. Run npm run validate to ensure it passes validation
  5. Run node scripts/generate-metadata.js to update indexes

📊 Statistics

  • 📚 14+ Utilities across 5 categories
  • 🏷️ 55+ Tags for easy discovery
  • 🌐 Cross-platform support (Linux, macOS, Windows)
  • 💯 100% Validated content with automated checks

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines on:

  • Adding new utilities
  • Improving existing content
  • Reporting issues
  • Suggesting features

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

🙏 Acknowledgments

Built with:


Made with ❤️ for developers, by developers

About

Util commands and scripts

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors