Local-Dev-Hub---ProjectsLister

Local Dev Hub — ProjectsLister

A premium, single-file local development cockpit designed to scan, list, and instantly search/launch your local projects. Styled with a beautiful modern glassmorphism interface, interactive background animations, smart category icons, and multiple selectable themes.

Developed & Watermarked by AmanProjects.

✨ Features

📂 Auto-Directory Scanning: Scans the root folder automatically to list all child projects.
🔍 Instant Fuzzy Filtering: Real-time client-side search to filter down projects as you type.
↕️ Dynamic Sorting: Toggle sorting direction (A → Z and Z → A) instantly without reloading.
🎨 Glassmorphism & Themes: Beautiful glass cards, custom gradients, floating orbs, and four gorgeous pre-configured visual themes:
- Space Glow (Default): Deep space-blue and violet neon gradients.
- Cyberpunk: Neon pink and cyan high-contrast dark theme.
- Emerald: Refreshing mint-green and teal gradients.
- Minimal Slate: Subdued, professional monochrome grey theme.
🏷️ Smart Category Emojis: Automatic icon assignment based on folder names (detects tags like react, next, vue, api, shop, blog, admin, chat, etc.).
⚙️ Interactive Web Installer: A dedicated web-based installation wizard (installer.php) to configure page title, dashboard headings, custom ignored directories, default sorting, and visual themes.
📱 Responsive Layout: Fully optimized for desktop, tablet, and mobile screens.

🛠️ Technology Stack

Backend: Core PHP (PHP 7.4+)
Frontend Structure: HTML5 (Semantic elements)
Styling: Vanilla CSS3 (Custom properties, grid systems, radial gradients, animations, glassmorphism filters)
Interactions: Vanilla JavaScript (ES6+, DOM filtering, key listeners)

🚀 Getting Started

Method A: Using the Web Installer (Recommended)

Copy index.php and installer.php into your local server directory (e.g. c:\xampp\htdocs\www\ProjectsLister\).
Open your web browser and navigate to the installer:
```
http://localhost/ProjectsLister/installer.php
```
The AmanProjects Installation Wizard will run diagnostic checks on your environment:
- Verifies PHP version compatiblity.
- Verifies directory write permissions.
- Verifies that directory scanner functions are active.
Fill in the configuration form (page title, excluded folder list, default sorting direction, and theme choice).
Click Generate Configuration & Install.
The installer will write config.php dynamically. Click Launch Dev Hub to enjoy your customized hub!

Method B: Manual Setup

If you prefer not to use the installer, copy index.php to your web directory. By default, it will scan all folders in its directory and run on the standard Space Glow theme.

To manually customize, create a file named config.php in the same directory:

<?php
/*
 * =========================================================
 * Local Dev Hub Configuration
 * Manually Configured
 * =========================================================
 */

return [
    'title' => 'My Projects — Local Dev Hub',
    'heading' => 'My Projects',
    'subtitle' => 'Browse and launch your local development projects instantly.',
    'exclude_dirs' => [
        '.',
        '..',
        '.git',
        '.github',
        '.idea',
        'node_modules',
        'phpmyadmin'
    ],
    'default_sort' => 'asc', // 'asc' or 'desc'
    'theme' => 'space' // 'space', 'cyberpunk', 'emerald', or 'minimal'
];

⚙️ Configuration Properties

Property	Type	Default	Description
`title`	`string`	`"My Projects — Local Dev Hub"`	The HTML browser tab title.
`heading`	`string`	`"My Projects"`	Title header shown on top of the dashboard.
`subtitle`	`string`	`"Browse and launch..."`	Caption text below the main heading.
`exclude_dirs`	`array`	`['.git', '.github', 'node_modules', ...]`	Folders to hide from the dashboard search list.
`default_sort`	`string`	`"asc"`	Default sorting direction when opening page (`asc` or `desc`).
`theme`	`string`	`"space"`	Visual CSS theme styling (`space`, `cyberpunk`, `emerald`, `minimal`).
`scan_dir`	`string`	`"parent"`	Directory to scan relative to the script location (`parent` or `current`).

🔒 Security Notice

Since the ProjectsLister lists all folders inside its directory, it is intended strictly for local development environments (localhost/XAMPP/WampServer).

Do not deploy this code to production web servers as it exposes directory structures to visitors.
We recommend deleting installer.php once config.php has been successfully created.

🏷️ Watermark & Branding

This dashboard contains premium styling, layout designs, and utility configurations developed by AmanProjects.

An elegant brand badge is integrated into the page header.
A watermarked link back to amanprojects.com is placed in the footer.
The installer is fully branded with the signature AmanProjects visual identity.

Made with ❤️ by AmanProjects.