# Maintenance Mode Implementation Plan > **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking. **Goal:** Add a toggle-able maintenance mode that redirects all public pages to a standalone "coming soon" page with waitlist signup. **Architecture:** New `maintenanceMode` boolean on `SiteSettings` entity, a kernel event subscriber that redirects non-admin requests when enabled, a standalone `/wkrotce` page with branding and waitlist form, and an admin toggle in the existing settings page. **Tech Stack:** Symfony 8.0, Doctrine ORM, Twig (standalone template), Stimulus (waitlist controller), Cloudflare Turnstile --- ## Chunk 1: Backend ### Task 1: Add maintenanceMode field to SiteSettings entity **Files:** - Modify: `src/Entity/SiteSettings.php` - [ ] **Step 1: Add field + getter + setter** After the `$enabledLocales` property, add: ```php #[ORM\Column(type: 'boolean', options: ['default' => true])] private bool $maintenanceMode = true; public function isMaintenanceMode(): bool { return $this->maintenanceMode; } public function setMaintenanceMode(bool $enabled): self { $this->maintenanceMode = $enabled; return $this; } ``` - [ ] **Step 2: Commit** ```bash git add src/Entity/SiteSettings.php git commit -m "Add maintenanceMode field to SiteSettings entity" ``` ### Task 2: Generate Doctrine migration **Files:** - Create: `migrations/VersionXXXX.php` (auto-generated) - [ ] **Step 1: Generate migration** Run: `php bin/console doctrine:migrations:diff` - [ ] **Step 2: Verify migration SQL** The migration should contain: ```sql ALTER TABLE site_settings ADD maintenance_mode BOOLEAN DEFAULT 1 NOT NULL ``` - [ ] **Step 3: Run migration locally** Run: `php bin/console doctrine:migrations:migrate --no-interaction` - [ ] **Step 4: Commit** ```bash git add migrations/ git commit -m "Add migration for maintenance_mode column" ``` ### Task 3: Add isMaintenanceMode() to SiteSettingsService **Files:** - Modify: `src/Service/SiteSettingsService.php` - [ ] **Step 1: Add proxy method** After `isLocaleEnabled()`, add: ```php public function isMaintenanceMode(): bool { return $this->get()->isMaintenanceMode(); } ``` - [ ] **Step 2: Commit** ```bash git add src/Service/SiteSettingsService.php git commit -m "Add isMaintenanceMode() to SiteSettingsService" ``` ### Task 4: Create MaintenanceSubscriber **Files:** - Create: `src/EventListener/MaintenanceSubscriber.php` - [ ] **Step 1: Create the subscriber** Follow the same pattern as `LocaleSubscriber.php`: ```php [['onKernelRequest', 10]], ]; } public function onKernelRequest(RequestEvent $event): void { if (!$event->isMainRequest()) { return; } if (!$this->settings->isMaintenanceMode()) { return; } $path = $event->getRequest()->getPathInfo(); if (str_starts_with($path, '/admin')) { return; } if ($path === '/wkrotce' || str_starts_with($path, '/api/waitlist')) { return; } if ($this->environment === 'dev' && (str_starts_with($path, '/_profiler') || str_starts_with($path, '/_wdt'))) { return; } try { if ($this->authChecker->isGranted('ROLE_ADMIN')) { return; } } catch (\Throwable) { // No firewall context (e.g. asset requests) — proceed with redirect } $event->setResponse(new RedirectResponse( $this->urlGenerator->generate('app_coming_soon'), 302 )); } } ``` Note: The `$environment` parameter will be autowired via `#[Autowire('%kernel.environment%')]` — but since Symfony 8 auto-wires scalar params by name from container params, we need the attribute. Update constructor: ```php use Symfony\Component\DependencyInjection\Attribute\Autowire; public function __construct( private SiteSettingsService $settings, private UrlGeneratorInterface $urlGenerator, private AuthorizationCheckerInterface $authChecker, #[Autowire('%kernel.environment%')] private string $environment, ) {} ``` - [ ] **Step 2: Commit** ```bash git add src/EventListener/MaintenanceSubscriber.php git commit -m "Add MaintenanceSubscriber to redirect public pages in maintenance mode" ``` ### Task 5: Create ComingSoonController **Files:** - Create: `src/Controller/ComingSoonController.php` - [ ] **Step 1: Create the controller** ```php isMaintenanceMode()) { return $this->redirectToRoute('app_home'); } return $this->render('coming_soon/index.html.twig', [ 'waitlist_count' => $em->getRepository(Waitlist::class)->count([]), 'turnstile_site_key' => $turnstile->getSiteKey(), ]); } } ``` - [ ] **Step 2: Commit** ```bash git add src/Controller/ComingSoonController.php git commit -m "Add ComingSoonController for /wkrotce route" ``` ### Task 6: Add maintenance toggle to admin settings **Files:** - Modify: `src/Controller/Admin/SettingsController.php` - Modify: `templates/admin/settings/index.html.twig` - [ ] **Step 1: Update controller POST handling** In `SettingsController::index()`, after the `setMonetizationEnabled` line, add: ```php $settings->setMaintenanceMode($request->request->getBoolean('maintenance_mode')); ``` - [ ] **Step 2: Add toggle to template** In `templates/admin/settings/index.html.twig`, add a new section **before** the "Widoczność sekcji" block (before line 17). Insert after the `` line: ```twig {# ── Tryb konserwacji ── #}

Tryb konserwacji

``` - [ ] **Step 3: Commit** ```bash git add src/Controller/Admin/SettingsController.php templates/admin/settings/index.html.twig git commit -m "Add maintenance mode toggle to admin settings page" ``` ## Chunk 2: Frontend — Coming Soon Page ### Task 7: Create standalone coming_soon template **Files:** - Create: `templates/coming_soon/index.html.twig` - [ ] **Step 1: Create the template** This is a standalone page (does NOT extend base.html.twig). It needs its own `` document with: - Tailwind CSS (from `var/tailwind/app.built.css`) - Inter font (self-hosted `/fonts/inter-var.woff2`) - `{{ importmap('app') }}` for Stimulus controllers (waitlist_controller) - Turnstile JS Design: - Background: cream `#FFFDF7`, full viewport height - Logo TROPO centered top (use `` directly, not LiipImagine macro since no base template) - Large bold heading "Startujemy niedługo" - Subtitle text - Waitlist form (same Stimulus `data-controller="waitlist"` pattern as download page) - Character icons (Scout, Blitz, Nova, Echo) as small decorative elements near the bottom - Waitlist count if > 0 - Turnstile widget with `data-theme="light"` - CSRF token via `{{ csrf_token('public_form') }}` ```twig TROPO — Startujemy niedługo {{ importmap('app') }} {# Logo #} TROPO {# Main content #}

Startujemy
niedługo

Przygoda jest bliżej niż myślisz. Zapisz się, a powiadomimy Cię o starcie.

{% if waitlist_count > 0 %}

Już {{ waitlist_count }} {{ waitlist_count == 1 ? 'osoba czeka' : 'osób czeka' }} na start

{% endif %}
{# Waitlist form #}
{# Character icons #}
Scout Blitz Nova Echo

© 2026 TROPO

``` Note: The Tailwind CSS file path should use `{{ asset('tailwind/app.built.css') }}` — but since this is standalone without the asset mapper providing the function fully, use the direct path. Verify the correct public path for the built CSS by checking what `base.html.twig` uses via `{% block stylesheets %}`. Actually, since `{{ importmap('app') }}` is available (it's a Twig function from Symfony), and `app.css` imports Tailwind, the CSS should be loaded via the importmap. Check if a separate `` is needed or if Tailwind CSS is already loaded through the asset pipeline. Adjust accordingly. - [ ] **Step 2: Verify locally** Run: `symfony serve` then visit `http://localhost:8000/wkrotce` Check: page renders with logo, heading, waitlist form, character icons. Form submits successfully via AJAX. - [ ] **Step 3: Commit** ```bash git add templates/coming_soon/index.html.twig git commit -m "Add standalone coming soon page template with waitlist form" ``` ### Task 8: Rebuild Tailwind CSS - [ ] **Step 1: Rebuild** Run: `php bin/console tailwind:build` Needed because the new template uses Tailwind classes that may not be in the existing build. - [ ] **Step 2: Commit if CSS changed** ```bash git add var/tailwind/app.built.css git commit -m "Rebuild Tailwind CSS for coming soon page" ``` ### Task 9: End-to-end verification - [ ] **Step 1: Test maintenance ON** 1. Go to `/admin/ustawienia`, enable maintenance toggle, save 2. Open incognito browser, visit `/` — should redirect to `/wkrotce` 3. Visit `/blog` — should redirect to `/wkrotce` 4. Visit `/wkrotce` — should show coming soon page 5. Submit waitlist form — should work (AJAX to `/api/waitlist`) - [ ] **Step 2: Test maintenance OFF** 1. Go to `/admin/ustawienia`, disable maintenance toggle, save 2. Open incognito, visit `/` — should show homepage normally 3. Visit `/wkrotce` — should redirect to `/` - [ ] **Step 3: Test admin access during maintenance** 1. Enable maintenance mode 2. As logged-in admin, visit `/` — should show homepage (not redirected) 3. Visit `/admin` — should work normally - [ ] **Step 4: Final commit with all changes** ```bash git add -A git commit -m "Add maintenance mode with coming soon page and admin toggle" ```