NativePHP for iOS

commit 98a6168ff79a5ac85027775bfd274b2e34199ebc
Merge: 115fd50 9838f1d
Author: Simon Hamp <[email protected]>
Date:   Sun Feb 2 10:55:16 2025 +0100

    Merge branch 'mobile-documentation' into mobile-documentation-simon

commit 115fd50819f5583046709f6f355f75978324da27
Author: Simon Hamp <[email protected]>
Date:   Sat Feb 1 21:31:11 2025 +0000

    Notifications

commit 912081696dac908ed686b45075704448b6efa562
Author: Simon Hamp <[email protected]>
Date:   Sat Feb 1 21:28:31 2025 +0000

    Dialogs

commit 1a62132db923e3671e71f933b08c59d7d1b24949
Author: Simon Hamp <[email protected]>
Date:   Sat Feb 1 21:20:10 2025 +0000

    Update desktop docs

commit 21b83f3a77ebf7c80f3e527b5d135b7843265536
Author: Simon Hamp <[email protected]>
Date:   Sat Feb 1 21:19:54 2025 +0000

    Add mobile docs

commit 9838f1d
Author: Eser DENIZ <[email protected]>
Date:   Sat Feb 1 13:35:54 2025 +0100

    fix: bug very large screen

commit e4154c6
Author: Eser DENIZ <[email protected]>
Date:   Mon Jan 27 17:06:08 2025 +0100

    refactor: linting

commit 4e55fa4
Author: Eser DENIZ <[email protected]>
Date:   Mon Jan 27 17:05:43 2025 +0100

    feat: seo title

commit ddcbbfa
Author: Eser DENIZ <[email protected]>
Date:   Mon Jan 27 17:00:21 2025 +0100

    feat: separating platforms into two distinct folders

commit 33d61ff
Author: Eser DENIZ <[email protected]>
Date:   Sun Jan 26 23:48:35 2025 +0100

    feat: mobile/desktop docs

Author: simonhamp

app/Http/Controllers/ShowDocumentationController.php

@@ -20,42 +20,42 @@
 
 class ShowDocumentationController extends Controller
 {
-    public function __invoke(Request $request, string $version, ?string $page = null)
+    public function __invoke(Request $request, string $platform, string $version, ?string $page = null)
     {
         if (config('app.env') === 'local') {
             Cache::flush();
         }
 
-        abort_unless(is_dir(resource_path('views/docs/'.$version)), 404);
+        abort_unless(is_dir(resource_path('views/docs/'.$platform.'/'.$version)), 404);
 
         session(['viewing_docs_version' => $version]);
+        session(['viewing_docs_platform' => $platform]);
 
-        $navigation = Cache::remember("docs_nav_{$version}", now()->addDay(), function () use ($version) {
-            return $this->getNavigation($version);
-        });
+        $navigation = Cache::remember("docs_nav_{$platform}_{$version}", now()->addDay(),
+            fn () => $this->getNavigation($platform, $version)
+        );
 
         if (is_null($page)) {
             return $this->redirectToFirstNavigationPage($navigation);
         }
 
         try {
-            $pageProperties = Cache::remember("docs_{$version}_{$page}", now()->addDay(),
-                function () use ($version, $page) {
-                    return $this->getPageProperties($version, $page);
-                });
+            $pageProperties = Cache::remember("docs_{$platform}_{$version}_{$page}", now()->addDay(),
+                fn () => $this->getPageProperties($platform, $version, $page)
+            );
         } catch (InvalidArgumentException $e) {
             return $this->redirectToFirstNavigationPage($navigation, $page);
         }
 
-        SEOTools::setTitle($pageProperties['title']);
+        SEOTools::setTitle($pageProperties['title'].' - NativePHP '.$platform.' v'.$version);
         SEOTools::setDescription(Arr::exists($pageProperties, 'description') ? $pageProperties['description'] : '');
 
         return view('docs.index')->with($pageProperties);
     }
 
-    protected function getPageProperties($version, $page = null): array
+    protected function getPageProperties($platform, $version, $page = null): array
     {
-        $markdownFileName = $version.'.'.($page ?? 'index');
+        $markdownFileName = $platform.'.'.$version.'.'.($page ?? 'index');
 
         $content = $this->getMarkdownView("docs.{$markdownFileName}", [
             'user' => auth()->user(),
@@ -64,16 +64,17 @@ protected function getPageProperties($version, $page = null): array
         $document = YamlFrontMatter::parse($content);
         $pageProperties = $document->matter();
 
-        $versionProperties = YamlFrontMatter::parseFile(resource_path("views/docs/{$version}/_index.md"));
+        $versionProperties = YamlFrontMatter::parseFile(resource_path("views/docs/{$platform}/{$version}/_index.md"));
         $pageProperties = array_merge($pageProperties, $versionProperties->matter());
 
+        $pageProperties['platform'] = $platform;
         $pageProperties['version'] = $version;
         $pageProperties['pagePath'] = request()->path();
 
-        $pageProperties['content'] = CommonMark::convertToHtml($document->body(), $version);
+        $pageProperties['content'] = CommonMark::convertToHtml($document->body());
         $pageProperties['tableOfContents'] = $this->extractTableOfContents($document->body());
 
-        $navigation = $this->getNavigation($version);
+        $navigation = $this->getNavigation($platform, $version);
         $pageProperties['navigation'] = Menu::build($navigation, function (Menu $menu, $nav) {
             if (array_key_exists('path', $nav)) {
                 $menu->link($nav['path'], $nav['title']);
@@ -110,7 +111,7 @@ protected function getPageProperties($version, $page = null): array
             ->setActive(\request()->path())
             ->__toString();
 
-        $pageProperties['editUrl'] = "https://github.com/NativePHP/nativephp.com/tree/main/resources/views/docs/{$version}/{$page}.md";
+        $pageProperties['editUrl'] = "https://github.com/NativePHP/nativephp.com/tree/main/resources/views/docs/{$platform}/{$version}/{$page}.md";
 
         // Find the next & previous page in the navigation
         $pageProperties['nextPage'] = null;
@@ -149,10 +150,10 @@ protected function getPageProperties($version, $page = null): array
         return $pageProperties;
     }
 
-    protected function getNavigation(string $version): array
+    protected function getNavigation(string $platform, string $version): array
     {
         $basePath = resource_path('views');
-        $path = "$basePath/docs/$version";
+        $path = "$basePath/docs/$platform/$version";
 
         $mainNavigation = (new Finder)
             ->files()
@@ -238,7 +239,6 @@ protected function extractTableOfContents(string $document): array
                 // Only search for level 2 and 3 headings.
                 return ! Str::startsWith($line, '## ') && ! Str::startsWith($line, '### ');
             })
-
             ->map(function (string $line) {
                 return [
                     'level' => strlen(trim(Str::before($line, '# '))) + 1,
@@ -259,9 +259,9 @@ protected function extractTitle(string $document): string
         return $matches[1] ?? '';
     }
 
-    protected function markdownViewExists($version, $page): bool
+    protected function markdownViewExists($platform, $version, $page): bool
     {
-        $markdownFileName = $version.'.'.($page ?? 'index');
+        $markdownFileName = $platform.'.'.$version.'.'.($page ?? 'index');
 
         try {
             $this->getMarkdownView("docs.{$markdownFileName}", [

package-lock.json

@@ -0,0 +1,4 @@
+<svg {{$attributes}} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" class="size-6">
+    <path stroke-linecap="round" stroke-linejoin="round" d="M9 17.25v1.007a3 3 0 0 1-.879 2.122L7.5 21h9l-.621-.621A3 3 0 0 1 15 18.257V17.25m6-12V15a2.25 2.25 0 0 1-2.25 2.25H5.25A2.25 2.25 0 0 1 3 15V5.25m18 0A2.25 2.25 0 0 0 18.75 3H5.25A2.25 2.25 0 0 0 3 5.25m18 0V12a2.25 2.25 0 0 1-2.25 2.25H5.25A2.25 2.25 0 0 1 3 12V5.25" />
+</svg>
+

resources/views/components/icons/computer-desktop.blade.php

@@ -0,0 +1 @@
+<svg {{$attributes}} xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-monitor-smartphone"><path d="M18 8V6a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v7a2 2 0 0 0 2 2h8"/><path d="M10 19v-3.96 3.15"/><path d="M7 19h5"/><rect width="6" height="10" x="16" y="12" rx="2"/></svg>

resources/views/components/icons/monitor-smartphone.blade.php

@@ -0,0 +1 @@
+<svg {{$attributes}} xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-tablet-smartphone"><rect width="10" height="14" x="3" y="8" rx="2"/><path d="M5 4a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v16a2 2 0 0 1-2 2h-2.4"/><path d="M8 18h.01"/></svg>

resources/views/components/icons/tablet-smartphone.blade.php

@@ -0,0 +1,21 @@
+@php
+    $isMobile = request()->is('docs/mobile/*');
+    $href= $isMobile ? '/docs/desktop/1' : '/docs/mobile/1';
+@endphp
+
+    <div {{ $attributes->class(['mb-6 p-3 text-sm space-y-2.5 rounded-md
+            text-gray-600 bg-gray-50/85 border border-gray-200
+            dark:text-gray-300 dark:bg-gray-800 dark:border-none
+            ']) }}>
+        <div>You're reading the documentation of NativePHP for {{ $isMobile? 'mobile' : 'desktop' }}.</div>
+        <x-link-subtle class="flex w-full gap-2 items-center" href="{{ $href }}">
+            @if($isMobile)
+                <x-icons.computer-desktop class="size-4"/>
+                Switch to desktop
+            @else
+                <x-icons.device-mobile-phone class="size-4"/>
+                Switch to mobile
+            @endif
+
+        </x-link-subtle>
+    </div>

resources/views/components/platform-switcher.blade.php

@@ -11,7 +11,9 @@
     border-r border-[#00aaa6] border-opacity-10 dark:border-gray-800
     dark:text-gray-200
  ">
-    <nav class="flex flex-col flex-1">
+    <nav class="flex flex-col flex-1 relative">
+        <x-platform-switcher/>
+
         {!! $slot !!}
     </nav>
 </div>
@@ -24,7 +26,10 @@
      x-transition:leave="transition ease-in duration-150"
      x-transition:leave-start="translate-y-0 opacity-100"
      x-transition:leave-end="translate-y-1 opacity-0"
-     class="fixed top-12 left-0 z-40 w-full h-screen pt-10 pb-16 overflow-y-auto bg-white dark:bg-gray-700 mt-2 px-4 border-b border-[#00aaa6] border-opacity-50 dark:border-opacity-90">
+     class="fixed top-12 left-0 z-40 w-full h-screen pt-10 pb-16 overflow-y-auto bg-white dark:bg-gray-700 mt-2 px-4 border-b border-[#00aaa6] border-opacity-50 dark:border-opacity-90"
+>
+
+    <x-platform-switcher/>
 
 
     {!! $slot !!}