- Added a new favicon and manifest file for the Truncgil Finance application to enhance branding and user experience.

- Updated the Scribe configuration to use a new theme and included a logo for better visual identity.
- Enhanced the welcome view by linking to the new manifest and updating the background image source for improved accessibility.
- Refactored API documentation to include updated response formats and example values, ensuring clarity and usability.
- Improved the layout and structure of the Scribe documentation pages for a more responsive design.

These changes collectively enhance the branding, accessibility, and usability of the Truncgil Finance application.

config/scribe.php

@@ -47,7 +47,7 @@ return [
     'type' => 'external_laravel',
 
     // See https://scribe.knuckles.wtf/laravel/reference/config#theme for supported options
-    'theme' => 'scalar',
+    'theme' => 'elements',
 
     'static' => [
         // HTML documentation, assets and Postman collection will be generated to this folder.
@@ -183,7 +183,7 @@ INTRO
     // For example, if your logo is in public/img:
     // - 'logo' => '../img/logo.png' // for `static` type (output folder is public/docs)
     // - 'logo' => 'img/logo.png' // for `laravel` type
-    'logo' => false,
+    'logo' => 'img/icons/icon-128x128.png',
 
     // Customize the "Last updated" value displayed in the docs by specifying tokens and formats.
     // Examples:

public/img/background.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 877 968"><g clip-path="url(#a)"><circle cx="391" cy="391" r="390.5" stroke="#009846" transform="matrix(-1 0 0 1 416 -56)" /><circle cx="468" cy="468" r="467.5" stroke="#009846" opacity=".3" transform="matrix(-1 0 0 1 493 -133)"/><circle cx="558" cy="558" r="557.5" stroke="#009846" opacity=".1" transform="matrix(-1 0 0 1 583 -223)" /><g filter="url(#b)"> <ellipse cx="583" cy="229.5" fill="#009846" rx="583" ry="229.5" transform="matrix(-1 0 0 1 621 -9)" /></g><g filter="url(#c)"><ellipse cx="262" cy="184.5" fill="#fff" rx="262" ry="184.5" transform="matrix(-1 0 0 1 99 42)" /></g></g><defs><filter id="b" width="1614" height="907" x="-769" y="-233" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix" /><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape" /><feGaussianBlur result="effect1_foregroundBlur_3089_39042" stdDeviation="112" /></filter><filter id="c" width="972" height="817" x="-649" y="-182" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix" /><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape" /><feGaussianBlur result="effect1_foregroundBlur_3089_39042" stdDeviation="112" /></filter><clipPath id="a"><path fill="#fff" d="M877 0H0v968h877z" /></clipPath></defs></svg>

public/manifest.json

@@ -0,0 +1,52 @@
+{
+  "name": "Truncgil Finance API",
+  "short_name": "Truncgil Finance",
+  "theme_color": "#009846",
+  "background_color": "#009846",
+  "display": "browser",
+  "orientation": "portrait",
+  "scope": "https://finance.truncgil.com/",
+  "start_url": "https://finance.truncgil.com/",
+  "icons": [
+    {
+      "src": "img/icons/icon-72x72.png",
+      "sizes": "72x72",
+      "type": "image/png"
+    },
+    {
+      "src": "img/icons/icon-96x96.png",
+      "sizes": "96x96",
+      "type": "image/png"
+    },
+    {
+      "src": "img/icons/icon-128x128.png",
+      "sizes": "128x128",
+      "type": "image/png"
+    },
+    {
+      "src": "img/icons/icon-144x144.png",
+      "sizes": "144x144",
+      "type": "image/png"
+    },
+    {
+      "src": "img/icons/icon-152x152.png",
+      "sizes": "152x152",
+      "type": "image/png"
+    },
+    {
+      "src": "img/icons/icon-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png"
+    },
+    {
+      "src": "img/icons/icon-384x384.png",
+      "sizes": "384x384",
+      "type": "image/png"
+    },
+    {
+      "src": "img/icons/icon-512x512.png",
+      "sizes": "512x512",
+      "type": "image/png"
+    }
+  ]
+}

resources/views/scribe/index.blade.php

@@ -1,23 +1,37 @@
+<!-- See https://github.com/stoplightio/elements/blob/main/docs/getting-started/elements/elements-options.md for config -->
 <!doctype html>
-<html>
+<html lang="en">
 <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
     <title>Truncgil Finance</title>
-    <meta charset="utf-8"/>
-    <meta
-        name="viewport"
-        content="width=device-width, initial-scale=1"/>
+    <!-- Embed elements Elements via Web Component -->
+    <script src="https://unpkg.com/@stoplight/elements/web-components.min.js"></script>
+    <link rel="stylesheet" href="https://unpkg.com/@stoplight/elements/styles.min.css">
     <style>
         body {
-            margin: 0;
+            height: 100vh;
         }
     </style>
 </head>
 <body>
+<elements-api
+    apiDescriptionUrl="{{ route("scribe.openapi") }}"
+    router="hash"
+    layout="responsive"
+    hideTryIt=""
+    logo="img/icons/icon-128x128.png"
+/>
 
-<script
-    id="api-reference"
-    data-url="{{ route("scribe.openapi") }}">
+<script>
+setTimeout(function() {
+    const linkElement = document.querySelector('a.sl-flex.sl-items-center.sl-px-4.sl-py-3.sl-border-t');
+    if (linkElement) {
+        linkElement.href = "https://truncgil.com"; // Yeni URL'yi buraya ekleyin
+        linkElement.innerHTML = '<img src="https://truncgil.com.tr/yatay.svg" alt="Açıklama">'; // Resim URL'sini ve alternatif metni buraya ekleyin
+    }
+}, 1000); // 1 saniye gecikme
 </script>
-<script src="https://cdn.jsdelivr.net/npm/@scalar/api-reference"></script>
+
 </body>
 </html>

resources/views/vendor/scribe/external/elements.blade.php

@@ -15,7 +15,6 @@
     </style>
 </head>
 <body>
-
 <elements-api
 @foreach($htmlAttributes as $attribute => $value)
     {{-- Attributes specified first override later ones --}}
@@ -23,12 +22,22 @@
 @endforeach
     apiDescriptionUrl="{!! $metadata['openapi_spec_url'] !!}"
     router="hash"
-    layout="sidebar"
+    layout="responsive"
     hideTryIt="{!! ($tryItOut['enabled'] ?? true) ? '' : 'true'!!}"
 @if(!empty($metadata['logo']))
     logo="{!! $metadata['logo'] !!}"
 @endif
 />
 
+<script>
+setTimeout(function() {
+    const linkElement = document.querySelector('a.sl-flex.sl-items-center.sl-px-4.sl-py-3.sl-border-t');
+    if (linkElement) {
+        linkElement.href = "https://truncgil.com"; // Yeni URL'yi buraya ekleyin
+        linkElement.innerHTML = '<img src="https://truncgil.com.tr/yatay.svg" alt="Truncgil Teknoloji">'; // Resim URL'sini ve alternatif metni buraya ekleyin
+    }
+}, 1000); // 1 saniye gecikme
+</script>
+
 </body>
 </html>