DevForge

Features

• Modern Dark Theme — Terminal-style UI built with ASCII and ANSI colors
• Startup Animation — Fast animated splash screen (ASCII-friendly)
• File Management — Browse, create, delete, rename, and organize files
• Built-in Editor — Simple text editor with save/quit commands
• Quick Preview — View files with line numbers without opening editor
• Directory & File Statistics — Workspace metrics and largest-file detection
• Template System — Create files from predefined templates (Python, HTML, JS, Bash, Markdown, JSON)
• Search & Recent Files — Pattern search and quick access to recent files
• Zero Dependencies — Works with Bash and standard UNIX utilities

Quick Start

1. Open a terminal and navigate to the project directory: cd ~/my-TUI
2. Run setup: bash setup.sh
3. Launch DevForge: ./devforge or ./main.sh

Make scripts executable

chmod +x devforge main.sh
./devforge

Usage Guide

Main Menu

[1] File Browser        - Navigate directories
[2] Create New File     - Create blank files
[3] Create from Template- Use project templates
[4] Open & Edit File    - Browse and edit
[5] Quick Preview       - View file without editing
[6] Search Files        - Find files by pattern
[7] Directory Stats     - Workspace metrics
[8] File Operations     - Advanced operations
[9] Recent Files        - Quick access history
[0] Exit                - Close DevForge
        

Editor Commands

• ::save - Save file and continue editing
• ::quit - Exit editor (prompts if unsaved changes)
• Type ::quit on a new line to save and exit (older versions used ::quit only)

Keyboard Navigation

• Use number keys 0-9 to select menu options
• Press b to go back
• Press Enter to confirm actions

DevForge v2.0 — What’s New

Major Updates

• Compatibility fixes — Removed problematic Unicode and improved ASCII output for universal terminals
• Template System — Create files from templates (Python, JS, HTML, Bash, Markdown, JSON)
• File Search & Recent Files — Find files and access recent history
• File Info — Line counts, words, characters, size, type
• Advanced Operations — Move files, bulk cleanup, duplication, rename

Template Options

[1] Python Script    - Complete Python template
[2] HTML Boilerplate - HTML5 with CSS
[3] JavaScript File  - JS template with main()
[4] Bash Script      - Shell script template
[5] README.md        - Markdown documentation
[6] JSON Config      - Config file template
        

File Operations Menu

[1] Create Directory     [2] Delete Item
[3] Rename Item         [4] Move Item
[5] Cleanup Empty Files
        

Documentation & Notes

System Requirements

• Bash 4.0+
• Unix-like system (Linux, macOS, WSL)
• Standard utilities: find, du, stat, wc
• Terminal with ANSI color support (256 colors recommended)

Supported Platforms

• Linux
• macOS
• WSL (Windows Subsystem for Linux)
• Containers and SSH sessions

Color Scheme

Primary accents use orange highlights and muted terminal colors for a professional look.

Workspace Structure (Example)

~/my-TUI/
├── main.sh
├── devforge
├── setup.sh
├── README.md
└── files/
    ├── sample.txt
    └── example.py
        

Troubleshooting

If scripts do not execute, ensure they are executable:

chmod +x main.sh devforge
./devforge

If colors do not display correctly, try:

TERM=xterm-256color ./devforge

Safety & Best Practices

• Destructive actions require explicit confirmation (type yes)
• Editor will prompt for unsaved changes
• Do not overwrite files accidentally

Advanced Features & Tips

• Use templates to quickly scaffold files
• Search using patterns and wildcards
• Use directory statistics to identify large files and structure
• Keep project templates in a config for consistent scaffolding

Performance Notes

• Fast startup and responsive menu navigation
• Minimal resource usage; suitable for remote sessions

Contributing

Edit main.sh to customize colors, templates, icons and menu options. Contributions are welcome; this tool is free to use and modify.

License

Created as a developer tool. Free to use and modify.