{"platform":"Cobonaut","version":"1.0","description":"Platforma do natychmiastowego wdrażania projektów webowych na produkcję. Oferuje kontenery chmurowe, repozytoria Git, domeny i serwery.","docsUrl":"https://cobonaut.com/docs","apiDocsUrl":"https://cobonaut.com/docs/api.md","llmDocsUrl":"https://cobonaut.com/llms-full.txt","baseUrl":"https://api.cobonaut.com/v1","supportedPlatforms":[{"key":"windows","name":"Standard Windows (PowerShell/CMD)"},{"key":"linux","name":"Standard Linux (Bash/sh)"},{"key":"macos","name":"Standard macOS (zsh/bash)"},{"key":"antigravity_windows","name":"Antigravity Agent on Windows"},{"key":"antigravity_linux","name":"Antigravity Agent on Linux/macOS"},{"key":"claude_code","name":"Claude Code CLI"},{"key":"cursor","name":"Cursor IDE"},{"key":"cline","name":"Cline / Roo-Cline Agent"},{"key":"copilot_workspace","name":"GitHub Copilot Workspace"},{"key":"codex","name":"OpenAI Codex / Custom API Agent"},{"key":"chatgpt_web","name":"ChatGPT Web Interface"},{"key":"claude_web","name":"Claude.ai Web Interface"},{"key":"web_llm","name":"Generic Web LLM Chat Interface"},{"key":"other","name":"Generic/Other platform"}],"templates":[{"key":"angular-basic-app","name":"Aplikacja Angular (Basic)","description":"Solidna, korporacyjna struktura oparta o framework Angular. Zawiera skonfigurowany router oraz podstawowy komponent powitalny.","version":"1.0.0","initPrompt":{"rules":["Projekt jest zbudowany w nowoczesnym Angularze. Pisz czysty TypeScript zgodny ze standardami Angular CLI.","Twórz komponenty w sposób modułowy, dbając o podział na widok (HTML), style (CSS/SCSS) oraz logikę (TS).","Używaj reaktywnego podejścia (RxJS) oraz Angular Service do zarządzania stanem i komunikacji.","Zawsze upewnij się, że wszystkie nowe komponenty są poprawnie zadeklarowane i zaimportowane w modułach lub jako standalone components.","Stosuj nowoczesne praktyki Angulara i dbaj o to, by kompilacja projektu przechodziła bez żadnych ostrzeżeń."],"styling":"Angular SCSS / Tailwind / Bootstrap","framework":"Angular (Modern Framework)"},"aiInstructions":"# AI Developer Instructions: Angular (Modern) Template\n\nThis project is built using Angular (modern framework, v15+) and is hosted on Cobonaut. As an AI coding assistant, follow these rules and guidelines when modifying this codebase.\n\n## 🛠 Tech Stack & Environment\n- **Framework:** Angular (v15+, Angular CLI)\n- **Language:** TypeScript\n- **Styling:** SCSS or CSS, optionally Bootstrap/Tailwind\n\n## 📂 Project Structure\n- `src/app/` - Application components and modules.\n  - `app.component.ts` - Main component logic.\n  - `app.component.html` - Main component template.\n  - `app.module.ts` - Root module (or standalone components in Angular 17+).\n- `src/main.ts` - Application bootstrap entry point.\n- `package.json` - Dependencies and build scripts.\n- `angular.json` - Angular CLI configuration.\n- `Dockerfile` - Builds the application and serves it using Nginx.\n\n## 💻 Development Workflow & Commands\nTo run and develop locally:\n1. Install dependencies:\n   ```bash\n   npm install\n   ```\n2. Start the local hot-reloading server:\n   ```bash\n   ng serve\n   ```\n3. Build for production:\n   ```bash\n   ng build --configuration production\n   ```\n\n## 🚀 Cobonaut Deployment Convention\n- To deploy changes to production:\n  1. Commit and push your changes to the Gitea repository branch `main`.\n  2. Trigger redeployment via the Cobonaut web dashboard by clicking the \"Wdróż\" (Deploy) button, or invoke the REST API:\n     ```http\n     POST https://api.cobonaut.com/v1/deploy\n     Authorization: Bearer cobo_live_[token]\n     ```\n"},{"key":"basic-page","name":"Podstawowa strona internetowa","description":"Standardowa, czysta strona internetowa zbudowana z użyciem HTML5, CSS3 i Vanilla JS. Idealna na proste landing page lub portfolio.","version":"1.0.0","initPrompt":{"rules":["Używaj wyłącznie czystego HTML5, Vanilla CSS3 oraz Vanilla JS w plikach bez zewnętrznych frameworków.","Możesz importować Bootstrap lub Tailwind przez CDN w index.html jeśli wymaga tego stylizacja.","Dbaj o semantyczną strukturę kodu HTML i przejrzyste arkusze stylów.","Wszystkie elementy interaktywne (np. formularze, slidery, modale) powinny mieć pełną logikę działania w czystym JS.","Wszystkie skrypty i style powinny być logicznie wydzielone lub umieszczone w index.html w estetyczny sposób."],"styling":"Vanilla CSS / Bootstrap CDN","framework":"Vanilla HTML5 / CSS3 / ES6 JS"},"aiInstructions":"# AI Developer Instructions: Basic HTML Page Template\n\nThis is a simple static HTML/CSS/JS page hosted on Cobonaut. As an AI coding assistant, follow these rules and guidelines when modifying this codebase.\n\n## 🛠 Tech Stack & Environment\n- **Languages:** HTML5, CSS3, Vanilla JavaScript (if added)\n- **Serving:** Served statically via Nginx in the production container\n\n## 📂 Project Structure\n- `index.html` - The single static entry point containing the webpage structure, styles, and scripts.\n- `Dockerfile` - Simple config to copy the files to an Nginx public directory for serving.\n\n## 💻 Development Workflow & Commands\nTo modify or preview the website locally:\n1. Open the folder in your workspace.\n2. Edit `index.html` directly. You can use standard local static preview tools or simply open `index.html` in a web browser.\n\n## 🚀 Cobonaut Deployment Convention\n- To deploy changes to production:\n  1. Commit and push your changes to the Gitea repository branch `main`.\n  2. Trigger redeployment via the Cobonaut web dashboard by clicking the \"Wdróż\" (Deploy) button, or invoke the REST API:\n     ```http\n     POST https://api.cobonaut.com/v1/deploy\n     Authorization: Bearer cobo_live_[token]\n     ```\n"},{"key":"medusa","name":"MedusaJS (Headless E-commerce)","description":"Nowoczesny, bezgłowy (headless) silnik e-commerce napisany w Node.js z architekturą opartą na mikroserwisach.","version":"1.0.0","initPrompt":null,"aiInstructions":"# AI Developer Instructions: MedusaJS Template\n\nThis project is built using MedusaJS (a headless commerce platform in Node.js) and is hosted on Cobonaut. As an AI coding assistant, follow these rules and guidelines when modifying this codebase.\n\n## 🛠 Tech Stack & Environment\n- **Framework:** MedusaJS (Node.js framework)\n- **Language:** JavaScript\n- **Database:** PostgreSQL (automatically provisioned by Cobonaut and injected via the `DATABASE_URL` environment variable)\n\n## 🗄 Database Configuration & Admin Login\n- Cobonaut automatically spins up a dedicated PostgreSQL database and database user for this project in the Kubernetes cluster.\n- The connection string is provided in the `DATABASE_URL` environment variable in the format: `postgresql://[user]:[password]@[host]:5432/[database]`.\n- Do not attempt to modify the database credentials or hardcode `DATABASE_URL` in files. Always read from `process.env.DATABASE_URL` (as configured in `medusa-config.js`).\n- **Default Admin Credentials**:\n  - **Email**: `admin@medusa-test.com`\n  - **Password**: `supersecretpassword`\n  - Use these credentials to access the admin dashboard at `/admin`.\n\n## 📂 Project Structure\n- `medusa-config.js` - Configuration settings for plugins, database connection, and store details.\n- `bootstrap.js` - Database bootstrap launcher script (runs migrations and seeds if necessary, then starts Medusa).\n- `package.json` - Dependencies, scripts (`start`, `build`), and config.\n- `Dockerfile` - Pre-builds the Medusa admin panel and runs the application in production.\n- `data/seed.json` - Initial seed data containing default store settings, regions, currencies, and products.\n\n## 💻 Development Workflow & Commands\nTo run and develop locally:\n1. Install dependencies:\n   ```bash\n   npm install\n   ```\n2. Start the development server (runs migrations automatically if needed):\n   ```bash\n   npm run start\n   ```\n\n## 🚀 Cobonaut Deployment Convention\n- To deploy changes to production:\n  1. Commit and push your changes to the Gitea repository branch `main`.\n  2. Trigger redeployment via the Cobonaut web dashboard by clicking the \"Wdróż\" (Deploy) button, or invoke the REST API:\n     ```http\n     POST https://api.cobonaut.com/v1/deploy\n     Authorization: Bearer cobo_live_[token]\n     ```\n"},{"key":"nextjs-basic-app","name":"Aplikacja Next.js (App Router)","description":"Profesjonalny szablon Next.js z architekturą App Router. Świetny wybór dla zaawansowanych, zoptymalizowanych pod SEO aplikacji SSR/SSG.","version":"1.0.0","initPrompt":{"rules":["Projekt jest oparty o Next.js (App Router). Używaj React Server Components (domyślnie) i 'use client' tylko tam, gdzie wymagana jest interakcja.","Do stylizacji używaj TailwindCSS. Dbaj o premium design: zaokrąglone krawędzie, harmonijne gradienty, subtelne cienie i mikromigacje.","Wykorzystuj pakiety 'lucide-react' do ikon oraz 'next/link' i 'next/image' do optymalizacji nawigacji i grafik.","Logikę biznesową i integracje API umieszczaj w katalogu src/app/api/ lub dedykowanych serwisach.","Dbaj o pełną responsywność (RWD) wszystkich stron oraz zgodność typów TypeScript."],"styling":"TailwindCSS","framework":"Next.js (App Router / React 18)"},"aiInstructions":"# AI Developer Instructions: Next.js Template\n\nThis project is built using Next.js (with App Router) and is hosted on Cobonaut. As an AI coding assistant, follow these rules and guidelines when modifying this codebase.\n\n## 🛠 Tech Stack & Environment\n- **Framework:** Next.js (App Router)\n- **Library:** React\n- **Language:** TypeScript\n- **Styling:** Tailwind CSS (configured in `tailwind.config.js` or standard CSS in `src/app/globals.css`)\n\n## 📂 Project Structure\n- `src/app/` - The Next.js App Router root folder.\n  - `page.tsx` - The main homepage file. Edit this to update the homepage interface.\n  - `layout.tsx` - Root layout wrapper.\n  - `globals.css` - Global CSS styles (includes Tailwind directives).\n- `next.config.js` - Next.js compiler and runtime configuration.\n- `package.json` - Dependencies and build scripts.\n- `Dockerfile` - Configured for standalone production builds deployed on CapRover.\n\n## 💻 Development Workflow & Commands\nTo run and develop locally:\n1. Install dependencies:\n   ```bash\n   npm install\n   ```\n2. Start the local hot-reloading development server:\n   ```bash\n   npm run dev\n   ```\n3. Test a production build locally:\n   ```bash\n   npm run build\n   ```\n\n## 🚀 Cobonaut Deployment Convention\n- To deploy changes to production:\n  1. Commit and push your changes to the Gitea repository branch `main`.\n  2. Trigger redeployment via the Cobonaut web dashboard by clicking the \"Wdróż\" (Deploy) button, or invoke the REST API:\n     ```http\n     POST https://api.cobonaut.com/v1/deploy\n     Authorization: Bearer cobo_live_[token]\n     ```\n"},{"key":"prestashop","name":"PrestaShop (PHP Store)","description":"Klasyczny sklep PrestaShop 8 z autorskim modułem integracyjnym i motywem dostosowanym do Twoich potrzeb.","version":"1.0.0","initPrompt":null,"aiInstructions":"# AI Developer Instructions: PrestaShop Template\n\nThis project is built using PrestaShop (e-commerce platform in PHP) and is hosted on Cobonaut. As an AI coding assistant, follow these rules and guidelines when modifying this codebase.\n\n## 🛠 Tech Stack & Environment\n- **Framework:** PrestaShop (PHP)\n- **Database:** MySQL\n- **Frontend Template Engine:** Smarty\n\n## 📂 Project Structure\nThis Gitea repository contains specific development folders rather than the whole PrestaShop core code:\n- `themes/` - Put your custom theme templates, CSS, and JS here.\n- `modules/` - Place custom or modified PrestaShop modules here.\n- The core PrestaShop deployment runs inside the CapRover container, mounting these directories to customize the shop.\n\n## 💻 Development Workflow & Commands\nSince the codebase only exposes the template/theme custom folder:\n1. To modify the appearance of the shop, edit files in `themes/[your-active-theme]/`.\n2. To modify shop behavior, create or update modules in `modules/[module-name]/`.\n\n## 🚀 Cobonaut Deployment Convention\n- To deploy changes to production:\n  1. Commit and push your changes to the Gitea repository branch `main`.\n  2. Trigger redeployment via the Cobonaut web dashboard by clicking the \"Wdróż\" (Deploy) button, or invoke the REST API:\n     ```http\n     POST https://api.cobonaut.com/v1/deploy\n     Authorization: Bearer cobo_live_[token]\n     ```\n  3. PrestaShop theme/module caches will clear automatically upon redeployment, reflecting your changes on the site.\n"},{"key":"react-basic-app","name":"Aplikacja React (Vite)","description":"Nowoczesna, ultraszybka aplikacja jednostronicowa (SPA) zbudowana z użyciem biblioteki React 18 i narzędzia budowania Vite.","version":"1.0.0","initPrompt":{"rules":["Projekt jest aplikacją React SPA. Pisz nowoczesne komponenty funkcyjne z użyciem React Hooks.","Do zarządzania stanem używaj standardowych hooków (useState, useEffect, useContext) lub bibliotek takich jak Zustand.","Zapewnij wysoką jakość interfejsu (UX/UI), stosując płynne przejścia, animacje hover i przemyślaną paletę kolorów.","Kod powinien być podzielony na reużywalne komponenty w folderze src/components.","Wszystkie importy i eksporty powinny być w standardzie ES Modules."],"styling":"Vanilla CSS / TailwindCSS / Bootstrap","framework":"React SPA (Vite / CRA)"},"aiInstructions":"# AI Developer Instructions: React (Vite) Template\n\nThis project is built using React (with Vite) and is hosted on Cobonaut. As an AI coding assistant, follow these rules and guidelines when modifying this codebase.\n\n## 🛠 Tech Stack & Environment\n- **Library:** React\n- **Build Tool:** Vite\n- **Language:** TypeScript\n- **Styling:** CSS/Tailwind (if configured)\n\n## 📂 Project Structure\n- `index.html` - The static HTML skeleton that mounts the React application.\n- `src/main.tsx` - App entry point mounting the React virtual DOM.\n- `src/App.tsx` - Main app component containing view logic and UI.\n- `package.json` - npm dependencies and scripts.\n- `Dockerfile` - Builds the static assets using Vite, and configures an Nginx server to serve them.\n\n## 💻 Development Workflow & Commands\nTo run and develop locally:\n1. Install dependencies:\n   ```bash\n   npm install\n   ```\n2. Start the local dev server:\n   ```bash\n   npm run dev\n   ```\n3. Build static production assets locally:\n   ```bash\n   npm run build\n   ```\n\n## 🚀 Cobonaut Deployment Convention\n- To deploy changes to production:\n  1. Commit and push your changes to the Gitea repository branch `main`.\n  2. Trigger redeployment via the Cobonaut web dashboard by clicking the \"Wdróż\" (Deploy) button, or invoke the REST API:\n     ```http\n     POST https://api.cobonaut.com/v1/deploy\n     Authorization: Bearer cobo_live_[token]\n     ```\n"},{"key":"simple-angularjs","name":"Klasyczny AngularJS (1.x)","description":"Klasyczna strona oparta o AngularJS 1.8. Idealne rozwiązanie do utrzymywania, testowania i nauki starszych technologii webowych.","version":"1.0.0","initPrompt":{"rules":["Projekt korzysta z klasycznego AngularJS (wersja 1.x). Pisz kod zgodny z architekturą MVC (Controllers, Scopes, Directives).","Do stylizacji wykorzystuj Bootstrap zainstalowany/zaimportowany w nagłówku index.html.","Wszelkie akcje użytkownika binduj za pomocą ng-model, ng-click, ng-show/ng-hide itp.","Zarządzaj danymi poprzez kontrolery powiązane z $scope lub składnią controllerAs.","Zachowaj strukturę jednoplitową (Single Page App) lub wydzielaj moduły i serwisy AngularJS zgodnie z klasycznymi wzorcami."],"styling":"Bootstrap CSS","framework":"AngularJS 1.8 (MVC)"},"aiInstructions":"# AI Developer Instructions: Legacy AngularJS (1.x) Template\n\nThis project is built using AngularJS (v1.x) and is hosted on Cobonaut. As an AI coding assistant, follow these rules and guidelines when modifying this codebase.\n\n## 🛠 Tech Stack & Environment\n- **Framework:** AngularJS (v1.x)\n- **Languages:** HTML5, CSS3, Vanilla JS\n- **Libraries:** AngularJS loaded from CDN (or locally referenced)\n\n## 📂 Project Structure\n- `index.html` - The webpage skeleton containing the AngularJS application module declaration (`ng-app`), controllers, templates, and styling.\n- `Dockerfile` - Builds the project and serves it using Nginx inside the production container.\n\n## 💻 Development Workflow & Commands\nTo modify or preview the website locally:\n1. Open the folder in your workspace.\n2. Edit `index.html` directly. You can use standard local static preview tools or simply open `index.html` in a web browser.\n\n## 🚀 Cobonaut Deployment Convention\n- To deploy changes to production:\n  1. Commit and push your changes to the Gitea repository branch `main`.\n  2. Trigger redeployment via the Cobonaut web dashboard by clicking the \"Wdróż\" (Deploy) button, or invoke the REST API:\n     ```http\n     POST https://api.cobonaut.com/v1/deploy\n     Authorization: Bearer cobo_live_[token]\n     ```\n"},{"key":"woocommerce","name":"WooCommerce (E-commerce Store)","description":"Kompletny sklep WooCommerce oparty na WordPress z zainstalowaną wtyczką WooCommerce i autorskim motywem sklepowym.","version":"1.0.0","initPrompt":null,"aiInstructions":"# AI Developer Instructions: WooCommerce Template\n\nThis project is built on WordPress with WooCommerce (PHP e-commerce platform) and is hosted on Cobonaut. As an AI coding assistant, follow these rules and guidelines when modifying this codebase.\n\n## 🛠 Tech Stack & Environment\n- **Platform:** WordPress (PHP) with WooCommerce plugin\n- **Database:** MySQL\n\n## 📂 Project Structure\nTo protect the core files, only specific theme and plugin directories are exposed in Gitea:\n- `themes/` - Place your custom themes and WooCommerce templates override here.\n- `plugins/` - Place custom plugins or extensions here.\n- The WooCommerce application runs in the CapRover container, mounting these directories to customize the shop.\n\n## 💻 Development Workflow & Commands\nTo customize the store:\n1. To modify the design, edit files inside `themes/[your-theme]/`.\n2. To add custom WooCommerce/WordPress logic, hooks, or custom templates, edit `themes/[your-theme]/functions.php` or create a new plugin under `plugins/[plugin-name]/`.\n\n## 🚀 Cobonaut Deployment Convention\n- To deploy changes to production:\n  1. Commit and push your changes to the Gitea repository branch `main`.\n  2. Trigger redeployment via the Cobonaut web dashboard by clicking the \"Wdróż\" (Deploy) button, or invoke the REST API:\n     ```http\n     POST https://api.cobonaut.com/v1/deploy\n     Authorization: Bearer cobo_live_[token]\n     ```\n  3. WordPress cache and asset optimizations will refresh upon redeployment.\n"},{"key":"wordpress","name":"WordPress (Custom Theme & Plugins)","description":"Szablon WordPress z prekonfigurowanym autorskim motywem Cobonaut oraz miejscem na Twoje wtyczki.","version":"1.0.0","initPrompt":null,"aiInstructions":"# AI Developer Instructions: WordPress Template\n\nThis project is built using WordPress (PHP blogging and CMS platform) and is hosted on Cobonaut. As an AI coding assistant, follow these rules and guidelines when modifying this codebase.\n\n## 🛠 Tech Stack & Environment\n- **Platform:** WordPress (PHP)\n- **Database:** MySQL\n\n## 📂 Project Structure\nTo protect the core files, only specific theme and plugin directories are exposed in Gitea:\n- `themes/` - Place your custom WordPress themes here.\n- `plugins/` - Place your custom WordPress plugins here.\n- The WordPress application runs in the CapRover container, mounting these directories to customize the site.\n\n## 🔌 Declarative Configuration (wordpress.json)\nYou can declare plugins, options, pages, categories, tags, users, and menus to be automatically setup upon deployment:\n- Edit the `wordpress.json` file in the root of the repository.\n- Use the following schema:\n  ```json\n  {\n    \"wordpress\": {\n      \"plugins\": [\n        \"contact-form-7\",\n        \"limit-login-attempts-reloaded\",\n        \"https://downloads.wordpress.org/plugin/classic-editor.1.6.3.zip\"\n      ],\n      \"options\": {\n        \"permalink_structure\": \"/%postname%/\",\n        \"show_on_front\": \"page\"\n      },\n      \"pages\": [\n        {\n          \"title\": \"Strona Główna\",\n          \"slug\": \"home\",\n          \"content\": \"<!-- wp:paragraph --><p>Content...</p><!-- /wp:paragraph -->\",\n          \"is_homepage\": true\n        },\n        {\n          \"title\": \"Kontakt\",\n          \"slug\": \"kontakt\",\n          \"content_file\": \"themes/cobonaut-theme/templates/page-contact-content.html\"\n        }\n      ],\n      \"posts\": [\n        {\n          \"title\": \"Jak zdać egzamin na prawo jazdy B\",\n          \"slug\": \"egzamin-prawo-jazdy-b\",\n          \"category\": \"guides\",\n          \"featured_image\": \"themes/cobonaut-theme/images/guides-featured.jpg\",\n          \"content_file\": \"themes/cobonaut-theme/posts/egzamin-b-content.php\",\n          \"template\": \"example.php\"\n        }\n      ],\n      \"categories\": [\n        {\n          \"name\": \"Aktualności\",\n          \"slug\": \"news\",\n          \"description\": \"Najświeższe wiadomości z życia firmy.\"\n        }\n      ],\n      \"tags\": [\n        {\n          \"name\": \"Poradniki\",\n          \"slug\": \"guides\"\n        }\n      ],\n      \"users\": [\n        {\n          \"username\": \"redaktor\",\n          \"email\": \"editor@example.com\",\n          \"role\": \"editor\",\n          \"password\": \"SecurePassword123!\"\n        }\n      ],\n      \"medias\": [\n        {\n          \"src\": \"themes/cobonaut-theme/images/guides-featured.jpg\",\n          \"url\": \"/wp-content/uploads/2026/06/guides-featured.jpg\"\n        }\n      ],\n      \"menus\": {\n        \"primary\": [\n          {\n            \"type\": \"page\",\n            \"slug\": \"home\",\n            \"title\": \"Główna\"\n          },\n          {\n            \"type\": \"page\",\n            \"slug\": \"kontakt\"\n          },\n          {\n            \"type\": \"custom\",\n            \"title\": \"Wsparcie Cobonaut\",\n            \"url\": \"https://cobonaut.com\"\n          }\n        ]\n      }\n    }\n  }\n  ```\n- Cobonaut's deployment pipeline parses this configuration and runs the necessary `wp-cli` commands automatically on start/redeploy (e.g., updating options, creating pages, settings the static homepage, configuring navigation menus, and creating tags, categories, or users).\n\n## 🖼 Media Synchronization & Resolution\nTo manage media files in your WordPress repository, declare them in the `.wordpress.medias` list in `wordpress.json` (as shown above). \n- Cobonaut automatically imports these files into the WordPress Media Library on redeploy.\n- Any media file removed from the `wordpress.json` list is automatically cleaned up and deleted from the cluster to save space, without affecting media uploaded manually by users via the WP admin dashboard.\n\n### How to resolve Media URLs (Avoid Hardcoding)\nSince WordPress uploads attachments to date-based paths (e.g., `wp-content/uploads/2026/06/...`), do not hardcode uploads URLs. Instead, resolve URLs using either of these approaches:\n\n1. **Static JSON Map (For AI Agents & Frontend HTML)**\n   Upon deployment, the pipeline automatically writes a public `/medias.json` file in the root of your WordPress directory containing the mapping of source paths to their actual live URLs. You can query this file to retrieve live assets path:\n   ```json\n   {\n     \"themes/cobonaut-theme/images/guides-featured.jpg\": \"https://your-app.cloud.cobonaut.com/wp-content/uploads/2026/06/guides-featured.jpg\"\n   }\n   ```\n\n2. **PHP Helper Function (For Theme templates)**\n   The helper function `get_cobo_media_url` is already built into the default theme's `functions.php` and is ready to use. If you generate a custom theme, make sure to copy this helper function to its `functions.php` file:\n   ```php\n   function get_cobo_media_url($source_path) {\n       $slug = pathinfo($source_path, PATHINFO_FILENAME);\n       $attachment = get_page_by_path($slug, OBJECT, 'attachment');\n       return $attachment ? wp_get_attachment_url($attachment->ID) : '';\n   }\n   ```\n   Usage in PHP templates:\n   `<img src=\"<?php echo get_cobo_media_url('themes/cobonaut-theme/images/guides-featured.jpg'); ?>\" />`\n\n## 💻 Development Workflow & Commands\nTo customize the WordPress site:\n1. To modify the theme templates or design, edit files inside `themes/[your-theme]/`.\n2. To add custom WordPress logic, hooks, or custom templates, edit `themes/[your-theme]/functions.php` or create a custom plugin under `plugins/[plugin-name]/`.\n\n## 🚀 Cobonaut Deployment Convention\n- To deploy changes to production:\n  1. Commit and push your changes to the Gitea repository branch `main`.\n  2. Trigger redeployment via the Cobonaut web dashboard by clicking the \"Wdróż\" (Deploy) button, or invoke the REST API:\n     ```http\n     POST https://api.cobonaut.com/v1/deploy\n     Authorization: Bearer cobo_live_[token]\n     ```\n  3. WordPress cache and asset optimizations will refresh upon redeployment.\n"},{"key":"laravel","name":"Projekt Laravel (PHP)","description":"Profesjonalny szablon Laravel dla nowoczesnych aplikacji webowych w języku PHP. Wsparcie dla baz danych, migracji, kolejek oraz systemu szablonów Blade.","version":"1.0.0","initPrompt":{"rules":["Projekt oparty jest o framework Laravel. Używaj architektury MVC (Model-View-Controller).","Widoki umieszczaj w katalogu resources/views/ jako szablony Blade. Do stylizacji używaj TailwindCSS.","Logikę biznesową umieszczaj w kontrolerach (app/Http/Controllers) lub dedykowanych serwisach, a logikę bazodanową w modelach (app/Models) i migracjach (database/migrations).","Używaj Eloquent ORM do interakcji z bazą danych.","Trasy (routes) definiuj w routes/web.php (dla widoków i stron) lub routes/api.php (dla API).","Dbaj o to, aby kod był bezpieczny, zoptymalizowany i zgodny ze standardami PSR."],"styling":"TailwindCSS / Blade Templates","framework":"Laravel (PHP 8.2+)"},"aiInstructions":"# AI Developer Instructions: Laravel Template\n\nThis project is built using Laravel (PHP) and is hosted on Cobonaut. As an AI coding assistant, follow these rules and guidelines when modifying this codebase.\n\n## 🛠 Tech Stack & Environment\n- **Framework:** Laravel (PHP 8.2+)\n- **Database:** MySQL (configured dynamically by Cobonaut)\n- **Language:** PHP 8.2+\n- **Styling:** Tailwind CSS / Blade Templates\n\n## 📂 Project Structure\n- `app/` - The core application logic.\n  - `Http/Controllers/` - Put page/request controller actions here.\n  - `Models/` - Eloquent database models.\n- `database/` - Migrations and seeders.\n  - `migrations/` - DB schema change scripts.\n- `resources/` - Frontend assets.\n  - `views/` - Blade views/templates. `welcome.blade.php` is the default homepage view.\n- `routes/` - Route declarations.\n  - `web.php` - HTTP web router.\n  - `api.php` - HTTP API router.\n- `public/` - Public assets, entrypoint for Apache (`index.php`).\n\n## 💻 Development Workflow & Commands\nTo run and develop locally:\n1. Install PHP dependencies:\n   ```bash\n   composer install\n   ```\n2. Start the local server:\n   ```bash\n   php artisan serve\n   ```\n3. Run database migrations:\n   ```bash\n   php artisan migrate\n   ```\n\n## 🚀 Cobonaut Deployment Convention\n- To deploy changes to production:\n  1. Commit and push your changes to the Gitea repository branch `main`.\n  2. Trigger redeployment via the Cobonaut web dashboard by clicking the \"Wdróż\" (Deploy) button.\n"},{"key":"custom-deploy","name":"Custom Deploy","description":"Niestandardowe wdrożenie z własnym Dockerfile lub captain-definition. Dedykowane dla kont komercyjnych z pełną izolacją sieciową.","version":"1.0.0","initPrompt":{"rules":["To jest niestandardowy szablon wdrożeniowy (Custom Deploy) bez z góry narzuconej struktury plików.","Użytkownik może samodzielnie definiować Dockerfile oraz pliki konfiguracyjne projektu."]},"aiInstructions":"# Instrukcje wdrożenia niestandardowego (Custom Deploy)\nMożesz umieścić własny plik `Dockerfile` lub `captain-definition` bezpośrednio w głównym katalogu tego repozytorium.\nSzablon ten jest objęty pełną izolacją sieciową (`cobo-custom-net`) – nie ma dostępu do sieci wewnętrznej innych kontenerów w Swarm.\n"},{"key":"react-postgres","name":"React + PostgreSQL (Next.js & Prisma)","description":"Klasyczny szablon aplikacji webowej Next.js (React) połączonej z bazą danych PostgreSQL za pomocą Prisma ORM. Zawiera panel administratora z logowaniem, pełen cykl migracji i przykładowy CRUD.","version":"1.0.0","initPrompt":null,"aiInstructions":"# AI Developer Instructions: React + PostgreSQL Template (Zero-Credential Architecture)\n\nThis project is a React web application integrated with a PostgreSQL database, built on Next.js (App Router) and Prisma ORM, hosted on Cobonaut. As an AI assistant, follow these rules and guidelines when modifying this codebase.\n\n## 🔒 Security Architecture (Zero-Credential Access)\n- The application process runs **without any database passwords or connection URLs** in its environment variables (`process.env.DATABASE_URL` is stripped at runtime).\n- SQL queries executed via `prisma` are automatically routed through an internal loopback adapter (`CobonautPgAdapter`) to a secure proxy managed in `private/db-proxy.js`.\n- You do not need to configure connection strings, proxies, ports, or secrets. Simply import `prisma` from `@/lib/db`.\n\n## 🛠 Tech Stack & Environment\n- **Framework:** Next.js (App Router)\n- **Language:** TypeScript\n- **CSS:** Tailwind CSS\n- **ORM / Database:** Prisma ORM with PostgreSQL\n\n## 📂 Project Structure\n- `prisma/schema.prisma` - Main database schema. Define new tables, columns, relations, and enums here.\n- `prisma/seed.ts` - Database seeding script. Executed automatically on every deployment.\n- `src/app/` - Next.js pages and routing.\n  - `src/app/page.tsx` - Public-facing homepage.\n  - `src/app/dashboard/` - Authenticated page for CRUD features.\n  - `src/app/api/` - Backend API routes using Prisma Client.\n- `src/lib/db.ts` - Zero-config Prisma Client singleton.\n- `package.json` - Node dependencies and scripts.\n- `bootstrap.js` - [PRIVATE] Starts background SQL proxy, executes migrations, strips secrets, and starts Next.js.\n- `db-proxy.js` - [PRIVATE] Secure SQL bridge listening exclusively on container loopback interface.\n\n## ⚠️ Rules & Best Practices for AI Developers\n1. **Database Access**: Always import `prisma` from `@/lib/db`. Never instantiate a new `PrismaClient` or direct `pg` connection in individual files.\n2. **Server Components vs Client Components**:\n   - **Server Components & API Routes (`src/app/api/...`)**: Can import and call `prisma` directly to fetch or mutate data on the server.\n   - **Client Components (`'use client'`)**: Must NOT import `prisma` directly. They must fetch data via Next.js API Routes (`fetch('/api/...')`).\n3. **Database Changes**: Never hardcode SQL strings for table creation. Always edit `prisma/schema.prisma` and commit generated migrations.\n\n## 🗄 Database Migrations Workflow\n1. **Schema Modifications**:\n   To change the database schema, modify `prisma/schema.prisma`. Example:\n   ```prisma\n   model Order {\n     id        String   @id @default(uuid())\n     title     String\n     createdAt DateTime @default(now())\n   }\n   ```\n2. **Generating Migrations**:\n   Run the Prisma CLI to generate SQL migration files:\n   ```bash\n   npx prisma migrate dev --name <migration_name>\n   ```\n   Commit the `prisma/migrations/` directory to Git.\n3. **Initial Data (Seeding)**:\n   Add default seed logic to `prisma/seed.ts` for populating initial system data or admin accounts on launch.\n"}],"scenarios":{"noAccount":{"description":"Użytkownik nie ma konta Cobonaut. Rozpocznij proces rejestracji.","detection":"Brak pliku konfiguracyjnego cobonaut.json w projekcie i brak tokenu API w .cob.env","steps":[{"step":1,"action":"Zapytaj użytkownika o adres email."},{"step":2,"action":"Wywołaj endpoint rejestracji.","method":"POST","url":"https://api.cobonaut.com/v1/register/request-code","body":{"email":"user@example.com","name":"Imię Nazwisko"},"description":"Serwer zwróci code (6 cyfr do podania userowi), agentSessionToken i statusPollingUrl. Dalsze kroki są opisane w polu instruction odpowiedzi."}]},"hasAccountNoProject":{"description":"Użytkownik ma konto i token API, ale nie ma jeszcze projektu.","detection":"Użytkownik podał token API (cobo_live_...) lub jest w pliku cobonaut.json, ale brak projectId.","steps":[{"step":1,"action":"Pobierz listę szablonów i utwórz projekt.","method":"POST","url":"https://api.cobonaut.com/v1/projects","headers":{"Authorization":"Bearer cobo_live_TOKEN"},"body":{"name":"Nazwa Projektu","templateKey":"nextjs-basic-app"},"description":"Serwer zwróci authenticatedRepoUrl do klonowania Git, projectId i dalsze instrukcje."},{"step":2,"action":"Sklonuj repozytorium z authenticatedRepoUrl, wprowadź zmiany, zrób git push."},{"step":3,"action":"Wdróż projekt.","method":"POST","url":"https://api.cobonaut.com/v1/deployments","body":{"projectId":"uuid-projektu","appName":"nazwa-subdomeny"}}]},"hasProject":{"description":"Użytkownik ma istniejący projekt (plik cobonaut.json z projectId i tokenem).","detection":"Plik cobonaut.json zawiera projectId i apiToken/gitToken.","steps":[{"step":1,"action":"Wprowadź zmiany w kodzie, zrób git add, commit i push."},{"step":2,"action":"Wywołaj deploy.","method":"POST","url":"https://api.cobonaut.com/v1/deploy","body":{"projectId":"uuid-z-cobonaut-json"},"description":"Serwer zwróci statusUrl do pollingu statusu wdrożenia."},{"step":3,"action":"Odpytuj status wdrożenia.","method":"GET","url":"https://api.cobonaut.com/v1/deployments/[deploymentId]/status","description":"Odpytuj co 5 sekund aż status zmieni się na 'running'."}]}},"configFileSpec":{"config":{"filename":"cobonaut.json","description":"Plik konfiguracyjny projektu Cobonaut. Przechowuj go w katalogu głównym projektu i zatwierdź w systemie kontroli wersji (Git).","exampleContent":{"projectId":"uuid-projektu","repoUrl":"https://git.cobonaut.com/user/project-id.git","appName":"moja-aplikacja","apiUrl":"https://api.cobonaut.com/"}},"env":{"filename":".cob.env","description":"Lokalny plik środowiskowy zawierający poufny token API. Ten plik NIE powinien być zatwierdzany w Git.","exampleContent":"COBONAUT_API_TOKEN=cobo_live_XXXXX"},"gitignore":{"description":"Dodaj plik .cob.env do pliku .gitignore w katalogu głównym projektu.","exampleContent":"\n# Cobonaut secrets\n.cob.env\n"}},"authInfo":{"type":"Bearer Token","headerFormat":"Authorization: Bearer cobo_live_[token]","description":"Wszystkie chronione endpointy wymagają nagłówka Authorization z tokenem API. Publiczne endpointy (start, register/*, health) nie wymagają autoryzacji."}}