Add custom paths and ACP tab

.gitignore

@@ -22,12 +22,14 @@
 /public/build
 /public/hot
 /public/storage
+/public/custom
 /storage/app
 /storage/framework
 /storage/*.key
 /storage/pail
 /storage/framework/views/*.php
 /bootstrap/cache/*.php
+/custom
 /vendor
 Homestead.json
 Homestead.yaml

CHANGELOG.md

@@ -5,6 +5,7 @@
 - Added CLI PHP interpreter options (php, keyhelp-php-domain, custom) with KeyHelp guidance.
 - Updated CLI update tooling and automation notes (KeyHelp PHP handling, CI runner requirements).
 - Adjusted ACP layout and tab styling for better dark-mode readability and auto-sizing sidebars.
+- Added Custom top-level ACP tab and preserved /custom paths during in-app updates.
 
 ## 2026-02-10
 - Reshaped ACP System tab with left navigation and dedicated views (Overview, Live Update, CLI, CI/CD).

app/Http/Controllers/SystemUpdateController.php

@@ -113,6 +113,7 @@ class SystemUpdateController extends Controller
             $append('Syncing files...');
             $usedRsync = false;
             $rsyncPath = trim((string) shell_exec('command -v rsync'));
+            $protectedPaths = ['custom', 'public/custom'];
             if ($rsyncPath !== '') {
                 $usedRsync = true;
                 $rsync = new Process([
@@ -122,6 +123,8 @@ class SystemUpdateController extends Controller
                     '--exclude=.env',
                     '--exclude=storage',
                     '--exclude=public/storage',
+                    '--exclude=custom',
+                    '--exclude=public/custom',
                     $sourceDir . '/',
                     base_path() . '/',
                 ]);
@@ -134,6 +137,15 @@ class SystemUpdateController extends Controller
                     ], 500);
                 }
             } else {
+                foreach ($protectedPaths as $path) {
+                    $sourcePath = $sourceDir . DIRECTORY_SEPARATOR . $path;
+                    if (File::exists($sourcePath)) {
+                        File::deleteDirectory($sourcePath);
+                        if (File::exists($sourcePath)) {
+                            File::delete($sourcePath);
+                        }
+                    }
+                }
                 File::copyDirectory($sourceDir, base_path());
             }
 

resources/js/pages/Acp.jsx

@@ -3778,15 +3778,9 @@ function Acp({ isAdmin }) {
                                 )}
                                 {systemSection === 'insite' && (
                                     <>
-                                        <div className="bb-acp-panel">
-                                            <div className="bb-acp-panel-header">
-                                                <h5 className="mb-0">Live Update</h5>
-                                            </div>
+                                        <div className="bb-acp-panel mb-3">
                                             <div className="bb-acp-panel-body">
-                                                <p className="bb-muted mb-0">
-                                                    Placeholder: run a live update from inside the forum, with safety checks
-                                                    and status details.
-                                                </p>
+                                                <p className="bb-muted mb-0">Live update controls will appear here.</p>
                                             </div>
                                         </div>
                                         {renderSystemRequirementsPanel()}
@@ -3862,6 +3856,23 @@ function Acp({ isAdmin }) {
                         </Row>
                     )}
                 </Tab>
+                <Tab eventKey="custom" title="Custom">
+                    <Row className="g-4">
+                        <Col xs={12}>
+                            <div className="bb-acp-panel">
+                                <div className="bb-acp-panel-header">
+                                    <h5 className="mb-0">Custom</h5>
+                                </div>
+                                <div className="bb-acp-panel-body">
+                                    <p className="bb-muted mb-0">
+                                        Place site-specific assets or overrides in `/custom` and `public/custom`.
+                                        These paths are preserved during in-place updates.
+                                    </p>
+                                </div>
+                            </div>
+                        </Col>
+                    </Row>
+                </Tab>
             </Tabs>
             <Modal show={showModal} onHide={handleReset} centered size="lg">
                 <Modal.Header closeButton closeVariant="white">