📦 PHPStrap Full Project Structure Guide
This document provides a detailed description of each major file and folder in the PHPStrap framework.
🗂️ Root Files
- index.php: The main landing page and front controller.
- install.php: Launches the setup wizard to configure the database.
- LICENSE: MIT license for open-source use.
- README.md: Project documentation and setup instructions.
- phpstrap.zip: Downloadable package archive.
🔧 /admin/
- dashboard.php: Admin dashboard overview page.
- destroy-session.php: Destroys session for logout.
- login.php / logout.php: Handles admin login/logout.
- logs.php: Displays system or module logs.
- modules.php: Admin panel for enabling/disabling modules.
- settings.php: Admin config and settings manager.
- users.php: Manage registered user accounts.
- includes/admin-auth.php: Protects admin pages behind login.
- includes/scan_modules.php: Scans module directories for registration.
🧱 /includes/
- header.php / footer.php: HTML templates for top and bottom layout.
- nav.php: Navigation menu component.
- header-scripts.php / footer-scripts.php: Includes JS/CSS assets.
- modules.php: Registers enabled modules for use.
- settings.php: Site-wide settings loader.
🛠️ /installer/
- config.php: Handles form input during install.
- database.php: Performs DB connection and table setup.
- requirements.php: PHP version and extension checks.
- ui.php: Installer UI and step loader.
📊 /dashboard/
- index.php: User-facing dashboard after login.
🎨 /assets/css/
and /assets/js/
- All Bootstrap 5 core files (minified, mapped, RTL versions).
- custom.css, dashboard.css, homepage.css: Theme-specific and layout styles.
- bootstrap.bundle.min.js: Bootstrap JavaScript functionality.
🗃️ /config/
- functions.php: Shared utility functions used across the framework.
📁 /css/
- Duplicate location for stylesheets, used in earlier builds or fallback support.
For help or contributions, visit GitHub Issues.