_____ ______ | __ \ | ____| | | | | _____ _| |__ ___ _ __ __ _ ___ | | | |/ _ \ \ / / __/ _ \| '__/ _` |/ _ \
| |__| | __/\ V /| | | (_) | | | (_| | __/
|_____/ \___| \_/ |_| \___/|_| \__, |\___|
__/ | |___/ 

⚡DevForge - Your Terminal Code Companion

A sleek, modern, dark-themed TUI for developers built entirely in bash. Code, manage files, and work efficiently right from your terminal.
Check out our website!

Features

• Modern Dark Theme - Sleek ASCII UI with vibrant colors and animations
• Startup Animation - Impressive animated splash screen
• File Management - Browse, create, delete, rename, and organize files
• Built-in Editor - Simple but functional file editor
• File Viewer - Preview file contents with line numbers
• Directory Stats - View statistics about your workspace
• Developer-Focused - Designed specifically for coders
• Zero Dependencies - Works with standard bash and coreutils

System Requirements

• Unix-like system (Linux, macOS)
• Bash 4.0+
• Standard utilities: find, du, stat

Quick Start

1. Navigate to the project directory

cd~/DevForge

2. Run the setup

bash setup.sh

3. Launch DevForge

./devforge

Or directly run:

./main.sh

Usage Guide

Main Menu Options

Option	Description
1	File Browser - Navigate and manage your files and directories
2	Create New File - Create a fresh file in your workspace
3	Open & Edit - Browse and edit existing files
4	Quick Preview - View file contents quickly
5	Directory Stats - See statistics about your files
6	File Operations - Delete, rename, or create directories
0	Exit - Close DevForge

File Operations

Creating Files

• Select option 2 from main menu
• Enter a filename with extension (e.g., script.py, index.html)
• Opens directly in the editor for content entry

Editing Files

• Select option 1 to browse files
• Choose a file to open the file menu
• Select 2 to edit
• Type your content
• Enter ::quit on a new line to save and exit

Managing Files

• View: See file contents with line numbers
• Copy: Duplicate files with a new name
• Delete: Remove files (confirmation required)
• Rename: Change file and directory names
• Create Directories: Organize files in folders

Keyboard Navigation

• Use number keys to select menu options
• Press b to go back to previous menu
• Press Enter to confirm actions
• Type ::quit in editor to save and exit

UI Elements

The TUI uses special ASCII characters for a modern look:

• ╔╗╚╝═║ - Box drawing characters for borders
• ▸ - Menu indicators (chevron)
• ✓ - Success indicator
• ✗ - Error indicator
• ⚠ - Warning symbol
• 📁 - Directory icon
• 📄 - File icon

Color Scheme

• Cyan - Primary UI elements, borders, highlights
• Green - Success messages, positive actions
• Yellow - Prompts and inputs
• Red - Error and delete operations
• White - Headers and important text
• Dark Gray - Secondary elements

Workspace Structure

~/DevForge/
├── main.sh # Main TUI application
├── devforge # Quick launcher script
├── setup.sh # Setup script
├── README.md # This file
└── files/ # Your workspace (auto-created)
├── sample.txt
├── example.py
└── [your files]

Example Usage

Creating a Python Script

1. Press 2 (Create New File)
2. Enter filename: hello.py
3. Start typing your Python code
4. Type ::quit to save

Project Organization

1. Press 6 (File Operations)
2. Press 3 (Create Directory)
3. Create directories like src/, docs/, tests/
4. Use File Browser to organize your files

🔧 Advanced Features

Quick File Preview (No Editing)

• Useful for quickly checking file contents without opening the editor
• Shows line numbers for reference
• Faster than full edit mode

Directory Statistics

• See total file count
• View total directory size
• Identify largest files
• Get workspace overview at a glance

Tips & Tricks

1. Fast Navigation - Use the file browser to quickly move between directories
2. Bulk Operations - Rename or delete batches of files one by one
3. File Copies - Use copy feature to quickly duplicate templates
4. Organization - Create directories to keep projects organized
5. Dark Mode - This TUI respects dark terminal themes for better visibility

Troubleshooting

Script won't execute

chmod +x /home/sysop/devforge/main.sh
chmod +x /home/sysop/devforge/devforge

Colors not displaying correctly

• Ensure your terminal supports ANSI colors
• Try running with: TERM=xterm-256color ./devforge

Files directory not found

• The files/ directory is created automatically on first run
• If missing, run: mkdir -p ~/devforge/files

Keyboard Shortcuts Reference

Key	Action
1-6	Select menu option
0	Exit/Quit
b	Go back
↵ Enter	Confirm
::quit	Save and exit editor
yes	Confirm destructive operations

Cool Features to Explore

• File statistics and workspace overview
• Nested directory navigation
• Quick preview without full editor
• Copy files to create templates
• Real-time ASCII animations

Performance Notes

• Fast startup with animated splash screen
• Responsive menu navigation
• Efficient file operations
• Minimal resource usage
• Perfect for remote SSH sessions

Notes

• All files are stored in ~/devforge/files/
• The editor is simple and text-based (great for small to medium files)
• For large file editing, still consider using nano, vim, or emacs
• The TUI remembers your last viewed file during a session

Contributing

Feel free to customize:

• Colors in the color scheme section
• ASCII art and UI elements
• Menu options and features
• Editor functionality

License

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

---

Enjoy coding with DevForge! ⚡

Made by SYOP200

For the best experience, use a terminal with true color support (256 colors minimum).