From d308d9a9a5b1c01350acf3e950db912ec7e0767a Mon Sep 17 00:00:00 2001 From: Lars Bergmann Date: Thu, 21 May 2026 16:44:30 +0200 Subject: [PATCH 01/11] vibecoding guide stub --- docs/guides/deployment/vibecoded_apps.mdx | 69 +++++++++++++++++++ .../guides/deployment/vibecoded_apps.mdx | 69 +++++++++++++++++++ 2 files changed, 138 insertions(+) create mode 100644 docs/guides/deployment/vibecoded_apps.mdx create mode 100644 i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/vibecoded_apps.mdx diff --git a/docs/guides/deployment/vibecoded_apps.mdx b/docs/guides/deployment/vibecoded_apps.mdx new file mode 100644 index 000000000..a7189f009 --- /dev/null +++ b/docs/guides/deployment/vibecoded_apps.mdx @@ -0,0 +1,69 @@ +--- +title: Deploying vibe coded apps +sidebar_label: Vibe coded apps +tags: + - Deployment + - GitHub + - Apps +description: Structure and quickstart for shipping vibe coded apps with a zero-conf approach +--- + +## Introduction / Motivation {#introduction-motivation} + +Why do we want to ship vibe coded apps in the first place? + +- TODO: define the product and business motivation +- TODO: describe expected speed and learning benefits +- TODO: clarify when vibecoding is a good fit and when it is not + +## Vibecoding app landscape overview {#vibecoding-app-landscape-overview} + +Apps are easy to create, but most vendors try to lock you in using proprietary deployments. + +- TODO: map common platform types and lock-in mechanisms +- TODO: outline migration friction and long-term costs +- TODO: contrast hosted convenience with portability + +## GitHub is our anchor {#github-is-our-anchor} + +If we can export to GitHub, we have good chances to deploy anywhere. + +- TODO: explain why Git history and repository ownership matter +- TODO: define minimum export requirements (code, config, build files) +- TODO: list pitfalls of partial or one-way exports + +## Principles and limits of zero conf deployments {#principles-and-limits-of-zero-conf-deployments} + +- TODO: define what zero conf means in this guide +- TODO: explain technical boundaries and trade-offs +- TODO: set expectations for cases that still need manual setup + +## Tips and tricks to work towards zero conf deployment {#tips-and-tricks-zero-conf-deployment} + +- TODO: coding patterns that improve deployability +- TODO: repository and environment variable hygiene +- TODO: practical checklist before first deployment + +## Zero conf deployment at mittwald {#zero-conf-deployment-at-mittwald} + +mw CLI, GitHub Action, extension. + +- TODO: brief overview of each path +- TODO: recommend decision criteria by team maturity +- TODO: reference follow-up guides and docs + +## Quickstart guide for zero conf deployment of vibe coded apps {#quickstart-zero-conf-deployment-vibe-coded-apps} + +- TODO: prerequisites +- TODO: local project preparation +- TODO: GitHub setup +- TODO: first deployment with mittwald +- TODO: verification and rollback basics + +## Final words and warnings {#final-words-and-warnings} + +Privacy, security, and operational responsibility. + +- TODO: privacy checklist for source and telemetry +- TODO: security baseline (secrets, dependency hygiene, least privilege) +- TODO: operational warnings and escalation guidance diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/vibecoded_apps.mdx b/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/vibecoded_apps.mdx new file mode 100644 index 000000000..92d93bf0a --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/vibecoded_apps.mdx @@ -0,0 +1,69 @@ +--- +title: Deployment von vibe coded apps +sidebar_label: Vibe coded apps +tags: + - Deployment + - GitHub + - Apps +description: Struktur und Schnellstart zum Deployen von vibe coded apps mit einem Zero-Conf-Ansatz +--- + +## Einführung / Motivation {#einfuehrung-motivation} + +Warum wollen wir vibe coded apps überhaupt produktiv ausrollen? + +- TODO: Produkt- und Business-Motivation definieren +- TODO: erwartete Geschwindigkeits- und Lernvorteile beschreiben +- TODO: klären, wann Vibecoding sinnvoll ist und wann nicht + +## Überblick über die Vibecoding-App-Landschaft {#ueberblick-vibecoding-app-landschaft} + +Apps sind schnell erstellt, aber viele Anbieter versuchen dich über proprietäre Deployments zu binden. + +- TODO: typische Plattformtypen und Lock-in-Mechanismen einordnen +- TODO: Migrationsaufwand und langfristige Kosten skizzieren +- TODO: Hosted-Komfort und Portabilität gegenüberstellen + +## GitHub ist unser Anker {#github-ist-unser-anker} + +Wenn wir nach GitHub exportieren können, haben wir gute Chancen, überall zu deployen. + +- TODO: erläutern, warum Git-Historie und Repository-Eigentum wichtig sind +- TODO: minimale Export-Anforderungen definieren (Code, Konfig, Build-Dateien) +- TODO: Stolperfallen bei unvollständigen oder einseitigen Exports benennen + +## Prinzipien und Grenzen von Zero-Conf-Deployments {#prinzipien-und-grenzen-zero-conf-deployments} + +- TODO: definieren, was Zero Conf in diesem Guide bedeutet +- TODO: technische Grenzen und Trade-offs erklären +- TODO: Erwartungsmanagement für Fälle mit manuellem Setup + +## Tipps und Tricks auf dem Weg zu Zero-Conf-Deployment {#tipps-und-tricks-zero-conf-deployment} + +- TODO: Coding-Patterns für bessere Deploybarkeit +- TODO: Hygiene bei Repository und Umgebungsvariablen +- TODO: praktische Checkliste vor dem ersten Deployment + +## Zero-Conf-Deployment bei mittwald {#zero-conf-deployment-bei-mittwald} + +mw CLI, GitHub Action, Extension. + +- TODO: kurze Übersicht über jeden Weg +- TODO: Entscheidungskriterien je nach Team-Reifegrad +- TODO: weiterführende Guides und Doku verlinken + +## Schnellstart für Zero-Conf-Deployment von vibe coded apps {#schnellstart-zero-conf-deployment-vibe-coded-apps} + +- TODO: Voraussetzungen +- TODO: lokales Projekt vorbereiten +- TODO: GitHub-Setup +- TODO: erstes Deployment mit mittwald +- TODO: Verifikation und Rollback-Grundlagen + +## Schlusswort und Warnhinweise {#schlusswort-und-warnhinweise} + +Datenschutz, Sicherheit und operative Verantwortung. + +- TODO: Datenschutz-Checkliste für Source und Telemetrie +- TODO: Security-Baseline (Secrets, Dependency-Hygiene, Least Privilege) +- TODO: operative Warnhinweise und Eskalationsweg From 0496e26711ebdadf084e57ae172326157adccdd2 Mon Sep 17 00:00:00 2001 From: Lars Bergmann Date: Fri, 22 May 2026 11:54:19 +0200 Subject: [PATCH 02/11] Finish first version --- docs/guides/deployment/vibecoded_apps.mdx | 162 +++++++++++++++++----- 1 file changed, 131 insertions(+), 31 deletions(-) diff --git a/docs/guides/deployment/vibecoded_apps.mdx b/docs/guides/deployment/vibecoded_apps.mdx index a7189f009..54f5c13a9 100644 --- a/docs/guides/deployment/vibecoded_apps.mdx +++ b/docs/guides/deployment/vibecoded_apps.mdx @@ -10,60 +10,160 @@ description: Structure and quickstart for shipping vibe coded apps with a zero-c ## Introduction / Motivation {#introduction-motivation} -Why do we want to ship vibe coded apps in the first place? +With upcoming and rapidly growing agentic coding capabilities, we want to make +it as easy as possible to ship "vibe coded" apps to the world. -- TODO: define the product and business motivation -- TODO: describe expected speed and learning benefits -- TODO: clarify when vibecoding is a good fit and when it is not +Besides rapid prototyping and development, we want to enable users to easily share their +vibe coded apps with others and deploy them to production environments without +needing to worry about complex deployment processes or configurations. + +Even small business apps can be built with vibe coding, this guide will help you to get +your vibe coded app from your local machine ( or cloud ai-driven IDE ) to the world with minimal friction. + +Deploying an app is exciting—and worth doing thoughtfully. Compliance, privacy, security and operational +responsibility matter, and we recommend connecting with our community if you have questions. ## Vibecoding app landscape overview {#vibecoding-app-landscape-overview} -Apps are easy to create, but most vendors try to lock you in using proprietary deployments. +Apps are easy to create, and deployment options vary widely. + +Different platforms offer different trade-offs. Vendors like Replit and Lovable prioritize developer speed +and ease of use with their specific project templates, build systems, and deployment pipelines. This convenience +comes with a trade-off: moving your app to another platform later may require rework. +On the other hand, you get a fast path to production with integrated tools and support. -- TODO: map common platform types and lock-in mechanisms -- TODO: outline migration friction and long-term costs -- TODO: contrast hosted convenience with portability +On the other hand, platforms like GitHub and mittwald offer more standard and flexible +deployment options that can be easily adapted to different environments. + +By using GitHub as a central repository for your vibe coded app, you can maintain +a clear history of changes, collaborate with others, and deploy to various platforms +without being tied to a specific vendor's ecosystem. + +This approach allows for greater freedom and control over your app's deployment +while still benefiting from the ease of use that vibe coding provides. ## GitHub is our anchor {#github-is-our-anchor} If we can export to GitHub, we have good chances to deploy anywhere. -- TODO: explain why Git history and repository ownership matter -- TODO: define minimum export requirements (code, config, build files) -- TODO: list pitfalls of partial or one-way exports +Most platforms support GitHub as a source for deployment, and having a well-structured +GitHub repository allows for better collaboration, version control, and integration +with various deployment tools and services. If GitHub is not the Git platform of choice, +the same principles apply to any other Git hosting service that supports similar features. + +The moment we can export our vibe coded app to GitHub, we can leverage a wide range of +deployment options, including continuous integration and continuous deployment (CI/CD) +pipelines and containerization. + +Many tools offer two-way synchronization with GitHub, which means that changes made in +the GitHub repository can be automatically reflected in the deployment environment, +and vice versa. This allows for a more seamless development and deployment process, +as developers can work on their code in GitHub while still having the benefits +of a live deployment environment. + +Export quality varies, so test locally first. A well-structured export that includes all necessary code, +configuration, and build files makes deployment and maintenance much easier. +A partial or incomplete export may require rework during deployment or maintenance, and can create +issues with version control and collaboration. ## Principles and limits of zero conf deployments {#principles-and-limits-of-zero-conf-deployments} -- TODO: define what zero conf means in this guide -- TODO: explain technical boundaries and trade-offs -- TODO: set expectations for cases that still need manual setup +As most platforms deploy with custom pipelines and configurations, +we need to define a common denominator for zero conf deployment. +In this context, zero conf deployment means that we can take the exported code from GitHub +and deploy it to a platform without needing to make any manual changes or configurations. + +In other words: End users should be able to deploy their vibe coded app with minimal setup, +ideally just by connecting their GitHub repository to a deployment platform that supports +zero conf deployment. + +Unfortunately, not all platforms support zero conf deployment, and even those that do may have +limitations or trade-offs to consider. For example, some platforms may require specific file +structures, configuration files, or build processes that may not be compatible with +the way vibe coded apps are exported. + +In other words: while zero conf deployment is an ideal goal, it may not always be achievable in practice, +and users may need to be prepared to make some manual adjustments or configurations in certain cases. + +A good practice to check exported code for zero conf compatibility is to try deploying it locally +using a tool like Docker or a local development server before attempting to deploy it to a cloud platform. +This can help identify any issues or missing components that may need to be addressed before deployment. ## Tips and tricks to work towards zero conf deployment {#tips-and-tricks-zero-conf-deployment} -- TODO: coding patterns that improve deployability -- TODO: repository and environment variable hygiene -- TODO: practical checklist before first deployment +During development, we can follow certain practices to improve the chances of achieving zero conf deployment. + +Keep the stack small: the more dependencies and services your app relies on, the more complex the deployment process becomes. + +Use standard tools and configurations: sticking to widely used tools and configurations can increase compatibility +with various deployment platforms. + +Document your app's requirements and dependencies clearly: this can help others understand what is needed to +deploy the app successfully and can also assist in troubleshooting any issues that arise during deployment. + +Audit security and privacy best practices: ensuring that your app follows security and privacy best practices +can help prevent issues during deployment and operation. Avoid hardcoding secrets, use environment variables, +and regularly review your dependencies for vulnerabilities. + +Deployment checklist: +- [ ] App runs locally without errors +- [ ] All secrets/keys are out of your code! +- [ ] README explains setup & usage +- [ ] Build/export scripts work +- [ ] Tested app in a browser/incognito window +- [ ] Backups: Save a copy of your project! +- [ ] Choose a reliable host that meets your needs +- [ ] Shared the link with a friend — get feedback +- [ ] Celebrate your first deploy! 🎉 ## Zero conf deployment at mittwald {#zero-conf-deployment-at-mittwald} -mw CLI, GitHub Action, extension. +mittwald offers a zero conf deployment option for vibe coded apps, +allowing users to deploy their apps directly from GitHub with minimal setup. + +In the present, two main paths for zero conf deployment of vibe coded apps are present: +- Manually via mittald CLI +- Automated via GitHub Action -- TODO: brief overview of each path -- TODO: recommend decision criteria by team maturity -- TODO: reference follow-up guides and docs +The recommended approach is to start with the manual CLI deployment to understand the +process and then move towards automation with GitHub Actions for a more streamlined +and efficient deployment workflow. + +A separate extension for mStudio is also in the works, which will further simplify +the deployment process by providing an integrated experience within the development environment. ## Quickstart guide for zero conf deployment of vibe coded apps {#quickstart-zero-conf-deployment-vibe-coded-apps} -- TODO: prerequisites -- TODO: local project preparation -- TODO: GitHub setup -- TODO: first deployment with mittwald -- TODO: verification and rollback basics +Prerequisites: +- A vibe coded app with a GitHub repository +- A mittwald hosting account +- Basic understanding of Git and GitHub +- mittwald CLI installed and configured + +Manual quickstart steps: +1. Prepare your vibe coded app for deployment by ensuring it runs locally and all dependencies are properly configured. +2. Make sure you are in sync with your GitHub repository and that all changes are committed and pushed. +3. Use the mittwald CLI to create a new project and call the deployment command in the folder context of your vibe coded app. + +Initial deployment takes a few minutes as the app is built the hosting environment is set up. +Once the deployment is complete, you can access your app via the provided URL. + +Test your app in a browser, and if you encounter any issues, check the logs and configuration to troubleshoot. + +After successful deployment, you can set up a GitHub Action to automate future deployments whenever you push +changes to your repository. Leverage git tags to manage releases and rollbacks effectively. + +## Moving forward: Best practices for success {#moving-forward-best-practices} -## Final words and warnings {#final-words-and-warnings} +As you prepare to deploy, consider these practices that help apps succeed: -Privacy, security, and operational responsibility. +- **Security and privacy matter.** Remove hardcoded secrets, use environment variables, and keep dependencies +up to date. These practices are straightforward and make your app more reliable. +- **Test early.** Deploy locally first, share with friends, and gather feedback before going live. +- **Community is here.** Our mittwald Discord server is a great place to ask questions, share what you're building, +and learn from other developers. +- **One size doesn't fit all.** Zero conf deployment works great for many apps. If your app has specific needs—complex +databases, custom infrastructure, or compliance requirements—that's fine too. Plan accordingly and don't hesitate to +reach out for guidance. -- TODO: privacy checklist for source and telemetry -- TODO: security baseline (secrets, dependency hygiene, least privilege) -- TODO: operational warnings and escalation guidance +You've built something cool. Ship it, learn from it, and iterate. That's the vibe. From 49c6fc3a67654b998b67b1b518ff36502120c827 Mon Sep 17 00:00:00 2001 From: Lars Bergmann Date: Fri, 22 May 2026 13:40:31 +0200 Subject: [PATCH 03/11] add quickstart commands --- docs/guides/deployment/vibecoded_apps.mdx | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/guides/deployment/vibecoded_apps.mdx b/docs/guides/deployment/vibecoded_apps.mdx index 54f5c13a9..ab0638d78 100644 --- a/docs/guides/deployment/vibecoded_apps.mdx +++ b/docs/guides/deployment/vibecoded_apps.mdx @@ -142,9 +142,26 @@ Prerequisites: Manual quickstart steps: 1. Prepare your vibe coded app for deployment by ensuring it runs locally and all dependencies are properly configured. + +```shellsession +user@local $ git clone https://github.com//.git +user@local $ cd +``` + 2. Make sure you are in sync with your GitHub repository and that all changes are committed and pushed. + +```shellsession +user@local $ git pull +user@local $ git status +``` + 3. Use the mittwald CLI to create a new project and call the deployment command in the folder context of your vibe coded app. +```shellsession +user@local $ mw project create --description= --update-context +user@local $ mw experimental deploy +``` + Initial deployment takes a few minutes as the app is built the hosting environment is set up. Once the deployment is complete, you can access your app via the provided URL. From e8e02f56c7b10d7abcfdca475cc9597a44d0ec64 Mon Sep 17 00:00:00 2001 From: Lars Bergmann Date: Tue, 26 May 2026 10:18:39 +0200 Subject: [PATCH 04/11] WIP, quickstart adjustments --- docs/guides/deployment/vibecoded_apps.mdx | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/guides/deployment/vibecoded_apps.mdx b/docs/guides/deployment/vibecoded_apps.mdx index ab0638d78..5a826450e 100644 --- a/docs/guides/deployment/vibecoded_apps.mdx +++ b/docs/guides/deployment/vibecoded_apps.mdx @@ -141,28 +141,28 @@ Prerequisites: - mittwald CLI installed and configured Manual quickstart steps: -1. Prepare your vibe coded app for deployment by ensuring it runs locally and all dependencies are properly configured. +1. Prepare your vibe coded app for deployment: verify that it runs locally and that all dependencies are installed. ```shellsession user@local $ git clone https://github.com//.git user@local $ cd ``` -2. Make sure you are in sync with your GitHub repository and that all changes are committed and pushed. +2. Make sure your local repository is in sync with GitHub and that your changes are committed and pushed. ```shellsession user@local $ git pull user@local $ git status ``` -3. Use the mittwald CLI to create a new project and call the deployment command in the folder context of your vibe coded app. +3. In your app folder, use the mittwald CLI to create a project and run the deployment command. ```shellsession user@local $ mw project create --description= --update-context user@local $ mw experimental deploy ``` -Initial deployment takes a few minutes as the app is built the hosting environment is set up. +Initial deployment takes a few minutes while the app is built and the hosting environment is set up. Once the deployment is complete, you can access your app via the provided URL. Test your app in a browser, and if you encounter any issues, check the logs and configuration to troubleshoot. @@ -170,6 +170,13 @@ Test your app in a browser, and if you encounter any issues, check the logs and After successful deployment, you can set up a GitHub Action to automate future deployments whenever you push changes to your repository. Leverage git tags to manage releases and rollbacks effectively. +Related guides for deeper setup: + +- For container-based CI/CD with GitHub Actions, see [Deploying containerized applications with GitHub Actions](/docs/v2/guides/deployment/container-actions/). +- For advanced deployment workflows and CI examples, see [Application deployment with deployer](/docs/v2/guides/deployment/deployer/). +- For container concepts, stack files, and registry setup, see [Containers](/docs/v2/platform/workloads/containers/). +- For declarative stack deployment commands, see [mw stack command reference](/docs/v2/cli/reference/stack/). + ## Moving forward: Best practices for success {#moving-forward-best-practices} As you prepare to deploy, consider these practices that help apps succeed: From eeeb25ca24cb7cc7c629568cd08aa7f841dd1746 Mon Sep 17 00:00:00 2001 From: Lars Bergmann Date: Wed, 27 May 2026 11:32:51 +0200 Subject: [PATCH 05/11] wording --- docs/guides/deployment/vibecoded_apps.mdx | 48 +++++++++++------------ 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/guides/deployment/vibecoded_apps.mdx b/docs/guides/deployment/vibecoded_apps.mdx index 5a826450e..40478c079 100644 --- a/docs/guides/deployment/vibecoded_apps.mdx +++ b/docs/guides/deployment/vibecoded_apps.mdx @@ -1,46 +1,46 @@ --- -title: Deploying vibe coded apps -sidebar_label: Vibe coded apps +title: Deploying AI-developed apps +sidebar_label: AI-developed apps tags: - Deployment - GitHub - Apps -description: Structure and quickstart for shipping vibe coded apps with a zero-conf approach +description: Structure and quickstart for shipping AI-developed apps with a zero-conf approach --- ## Introduction / Motivation {#introduction-motivation} -With upcoming and rapidly growing agentic coding capabilities, we want to make -it as easy as possible to ship "vibe coded" apps to the world. +With rapidly advancing AI-driven development tools, building applications has become more accessible than ever. +We want to make it as easy as possible to take the apps you create—whether prototyped quickly or developed thoughtfully—and ship them to the world with confidence. Besides rapid prototyping and development, we want to enable users to easily share their -vibe coded apps with others and deploy them to production environments without +AI-developed apps with others and deploy them to production environments without needing to worry about complex deployment processes or configurations. -Even small business apps can be built with vibe coding, this guide will help you to get -your vibe coded app from your local machine ( or cloud ai-driven IDE ) to the world with minimal friction. +Whether you're building a small business app or a more complex application using AI-driven development, this guide will help you get +your app from your local machine (or cloud-based IDE) to the world with minimal friction. Deploying an app is exciting—and worth doing thoughtfully. Compliance, privacy, security and operational responsibility matter, and we recommend connecting with our community if you have questions. -## Vibecoding app landscape overview {#vibecoding-app-landscape-overview} +## AI-developed app landscape overview {#ai-developed-app-landscape-overview} -Apps are easy to create, and deployment options vary widely. +Apps built through AI-driven development are easy to create, and deployment options vary widely. Different platforms offer different trade-offs. Vendors like Replit and Lovable prioritize developer speed and ease of use with their specific project templates, build systems, and deployment pipelines. This convenience comes with a trade-off: moving your app to another platform later may require rework. On the other hand, you get a fast path to production with integrated tools and support. -On the other hand, platforms like GitHub and mittwald offer more standard and flexible +Platforms like GitHub and mittwald, on the other hand, offer more standard and flexible deployment options that can be easily adapted to different environments. -By using GitHub as a central repository for your vibe coded app, you can maintain +By using GitHub as a central repository for your AI-developed app, you can maintain a clear history of changes, collaborate with others, and deploy to various platforms without being tied to a specific vendor's ecosystem. This approach allows for greater freedom and control over your app's deployment -while still benefiting from the ease of use that vibe coding provides. +while still benefiting from the ease and speed that AI-driven development provides. ## GitHub is our anchor {#github-is-our-anchor} @@ -51,7 +51,7 @@ GitHub repository allows for better collaboration, version control, and integrat with various deployment tools and services. If GitHub is not the Git platform of choice, the same principles apply to any other Git hosting service that supports similar features. -The moment we can export our vibe coded app to GitHub, we can leverage a wide range of +The moment we can export our AI-developed app to GitHub, we can leverage a wide range of deployment options, including continuous integration and continuous deployment (CI/CD) pipelines and containerization. @@ -73,14 +73,14 @@ we need to define a common denominator for zero conf deployment. In this context, zero conf deployment means that we can take the exported code from GitHub and deploy it to a platform without needing to make any manual changes or configurations. -In other words: End users should be able to deploy their vibe coded app with minimal setup, +In other words: End users should be able to deploy their AI-developed app with minimal setup, ideally just by connecting their GitHub repository to a deployment platform that supports zero conf deployment. Unfortunately, not all platforms support zero conf deployment, and even those that do may have limitations or trade-offs to consider. For example, some platforms may require specific file structures, configuration files, or build processes that may not be compatible with -the way vibe coded apps are exported. +the way AI-developed apps are exported. In other words: while zero conf deployment is an ideal goal, it may not always be achievable in practice, and users may need to be prepared to make some manual adjustments or configurations in certain cases. @@ -118,11 +118,11 @@ Deployment checklist: ## Zero conf deployment at mittwald {#zero-conf-deployment-at-mittwald} -mittwald offers a zero conf deployment option for vibe coded apps, +mittwald offers a zero conf deployment option for AI-developed apps, allowing users to deploy their apps directly from GitHub with minimal setup. -In the present, two main paths for zero conf deployment of vibe coded apps are present: -- Manually via mittald CLI +In the present, two main paths for zero conf deployment of AI-developed apps are present: +- Manually via mittwald CLI - Automated via GitHub Action The recommended approach is to start with the manual CLI deployment to understand the @@ -132,16 +132,16 @@ and efficient deployment workflow. A separate extension for mStudio is also in the works, which will further simplify the deployment process by providing an integrated experience within the development environment. -## Quickstart guide for zero conf deployment of vibe coded apps {#quickstart-zero-conf-deployment-vibe-coded-apps} +## Quickstart guide for zero conf deployment of AI-developed apps {#quickstart-zero-conf-deployment-ai-developed-apps} Prerequisites: -- A vibe coded app with a GitHub repository +- An AI-developed app with a GitHub repository - A mittwald hosting account - Basic understanding of Git and GitHub - mittwald CLI installed and configured Manual quickstart steps: -1. Prepare your vibe coded app for deployment: verify that it runs locally and that all dependencies are installed. +1. Prepare your AI-developed app for deployment: verify that it runs locally and that all dependencies are installed. ```shellsession user@local $ git clone https://github.com//.git @@ -186,8 +186,8 @@ up to date. These practices are straightforward and make your app more reliable. - **Test early.** Deploy locally first, share with friends, and gather feedback before going live. - **Community is here.** Our mittwald Discord server is a great place to ask questions, share what you're building, and learn from other developers. -- **One size doesn't fit all.** Zero conf deployment works great for many apps. If your app has specific needs—complex +- **One size doesn't fit all.** Zero conf deployment works great for many AI-developed apps. If your app has specific needs—complex databases, custom infrastructure, or compliance requirements—that's fine too. Plan accordingly and don't hesitate to reach out for guidance. -You've built something cool. Ship it, learn from it, and iterate. That's the vibe. +You've built something cool. Ship it, learn from it, and iterate. From 9625d8d550e5f810979ce88d18845600d365701f Mon Sep 17 00:00:00 2001 From: Lars Bergmann Date: Wed, 27 May 2026 12:56:13 +0200 Subject: [PATCH 06/11] dash rules --- .github/instructions/DOCS.instructions.md | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/instructions/DOCS.instructions.md b/.github/instructions/DOCS.instructions.md index 2d2c86515..343a1c8af 100644 --- a/.github/instructions/DOCS.instructions.md +++ b/.github/instructions/DOCS.instructions.md @@ -15,6 +15,7 @@ Pay special attention to these guidelines when authoring and reviewing documenta - Markdown sub-headings within a document must have explicit anchor IDs for stable linking (this does not apply to the markdown front matter); suggest changes during code review if missing - Use the `` component for linking to API operations, and `` for including example requests. Do not link to API operations by hardcoding URLs or markdown links to the reference docs, as these are brittle and will break if the operation name or URL changes. +- **Dash usage:** Use hyphens (`-`) for compound words and ranges (e.g., "open-source", "2024-2025"). Use em dashes (`—`) for parenthetical asides and sentence breaks (e.g., "Deploy your app — with integrated tools — in minutes"). Use en dashes (`–`) sparingly, only for numeric ranges when em dash or hyphen is inappropriate. ## Security From e5402acf87d57c08cc37c8cd947ef0640dd13d34 Mon Sep 17 00:00:00 2001 From: Lars Bergmann Date: Wed, 27 May 2026 13:38:04 +0200 Subject: [PATCH 07/11] German translation --- ...becoded_apps.mdx => ai_developed_apps.mdx} | 34 +-- .../guides/deployment/ai_developed_apps.mdx | 193 ++++++++++++++++++ .../guides/deployment/vibecoded_apps.mdx | 69 ------- 3 files changed, 210 insertions(+), 86 deletions(-) rename docs/guides/deployment/{vibecoded_apps.mdx => ai_developed_apps.mdx} (87%) create mode 100644 i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx delete mode 100644 i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/vibecoded_apps.mdx diff --git a/docs/guides/deployment/vibecoded_apps.mdx b/docs/guides/deployment/ai_developed_apps.mdx similarity index 87% rename from docs/guides/deployment/vibecoded_apps.mdx rename to docs/guides/deployment/ai_developed_apps.mdx index 40478c079..dc7b19265 100644 --- a/docs/guides/deployment/vibecoded_apps.mdx +++ b/docs/guides/deployment/ai_developed_apps.mdx @@ -11,7 +11,7 @@ description: Structure and quickstart for shipping AI-developed apps with a zero ## Introduction / Motivation {#introduction-motivation} With rapidly advancing AI-driven development tools, building applications has become more accessible than ever. -We want to make it as easy as possible to take the apps you create—whether prototyped quickly or developed thoughtfully—and ship them to the world with confidence. +We want to make it as easy as possible to take the apps you create — whether prototyped quickly or developed thoughtfully — and ship them to the world with confidence. Besides rapid prototyping and development, we want to enable users to easily share their AI-developed apps with others and deploy them to production environments without @@ -20,7 +20,7 @@ needing to worry about complex deployment processes or configurations. Whether you're building a small business app or a more complex application using AI-driven development, this guide will help you get your app from your local machine (or cloud-based IDE) to the world with minimal friction. -Deploying an app is exciting—and worth doing thoughtfully. Compliance, privacy, security and operational +Deploying an app is exciting — and worth doing thoughtfully. Compliance, privacy, security and operational responsibility matter, and we recommend connecting with our community if you have questions. ## AI-developed app landscape overview {#ai-developed-app-landscape-overview} @@ -66,32 +66,32 @@ configuration, and build files makes deployment and maintenance much easier. A partial or incomplete export may require rework during deployment or maintenance, and can create issues with version control and collaboration. -## Principles and limits of zero conf deployments {#principles-and-limits-of-zero-conf-deployments} +## Principles and limits of zero-conf deployments {#principles-and-limits-of-zero-conf-deployments} As most platforms deploy with custom pipelines and configurations, -we need to define a common denominator for zero conf deployment. -In this context, zero conf deployment means that we can take the exported code from GitHub +we need to define a common denominator for zero-conf deployment. +In this context, zero-conf deployment means that we can take the exported code from GitHub and deploy it to a platform without needing to make any manual changes or configurations. In other words: End users should be able to deploy their AI-developed app with minimal setup, ideally just by connecting their GitHub repository to a deployment platform that supports -zero conf deployment. +zero-conf deployment. -Unfortunately, not all platforms support zero conf deployment, and even those that do may have +Unfortunately, not all platforms support zero-conf deployment, and even those that do may have limitations or trade-offs to consider. For example, some platforms may require specific file structures, configuration files, or build processes that may not be compatible with the way AI-developed apps are exported. -In other words: while zero conf deployment is an ideal goal, it may not always be achievable in practice, +In other words: while zero-conf deployment is an ideal goal, it may not always be achievable in practice, and users may need to be prepared to make some manual adjustments or configurations in certain cases. -A good practice to check exported code for zero conf compatibility is to try deploying it locally +A good practice to check exported code for zero-conf compatibility is to try deploying it locally using a tool like Docker or a local development server before attempting to deploy it to a cloud platform. This can help identify any issues or missing components that may need to be addressed before deployment. -## Tips and tricks to work towards zero conf deployment {#tips-and-tricks-zero-conf-deployment} +## Tips and tricks to work towards zero-conf deployment {#tips-and-tricks-zero-conf-deployment} -During development, we can follow certain practices to improve the chances of achieving zero conf deployment. +During development, we can follow certain practices to improve the chances of achieving zero-conf deployment. Keep the stack small: the more dependencies and services your app relies on, the more complex the deployment process becomes. @@ -116,12 +116,12 @@ Deployment checklist: - [ ] Shared the link with a friend — get feedback - [ ] Celebrate your first deploy! 🎉 -## Zero conf deployment at mittwald {#zero-conf-deployment-at-mittwald} +## Zero-conf deployment at mittwald {#zero-conf-deployment-at-mittwald} -mittwald offers a zero conf deployment option for AI-developed apps, +mittwald offers a zero-conf deployment option for AI-developed apps, allowing users to deploy their apps directly from GitHub with minimal setup. -In the present, two main paths for zero conf deployment of AI-developed apps are present: +In the present, two main paths for zero-conf deployment of AI-developed apps are present: - Manually via mittwald CLI - Automated via GitHub Action @@ -132,7 +132,7 @@ and efficient deployment workflow. A separate extension for mStudio is also in the works, which will further simplify the deployment process by providing an integrated experience within the development environment. -## Quickstart guide for zero conf deployment of AI-developed apps {#quickstart-zero-conf-deployment-ai-developed-apps} +## Quickstart guide for zero-conf deployment of AI-developed apps {#quickstart-zero-conf-deployment-ai-developed-apps} Prerequisites: - An AI-developed app with a GitHub repository @@ -186,8 +186,8 @@ up to date. These practices are straightforward and make your app more reliable. - **Test early.** Deploy locally first, share with friends, and gather feedback before going live. - **Community is here.** Our mittwald Discord server is a great place to ask questions, share what you're building, and learn from other developers. -- **One size doesn't fit all.** Zero conf deployment works great for many AI-developed apps. If your app has specific needs—complex -databases, custom infrastructure, or compliance requirements—that's fine too. Plan accordingly and don't hesitate to +- **One size doesn't fit all.** Zero-conf deployment works great for many AI-developed apps. If your app has specific needs — complex +databases, custom infrastructure, or compliance requirements — that's fine too. Plan accordingly and don't hesitate to reach out for guidance. You've built something cool. Ship it, learn from it, and iterate. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx b/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx new file mode 100644 index 000000000..8902e0feb --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx @@ -0,0 +1,193 @@ +--- +title: Deployment von mit KI entwickelten Apps +sidebar_label: Mit KI entwickelte Apps +tags: + - Deployment + - GitHub + - Apps +description: Struktur und Schnellstart zum Deployen von mit KI entwickelten Apps mit einem Zero-Conf-Ansatz +--- + +## Einführung / Motivation {#einfuehrung-motivation} + +Mit rasant voranschreitenden KI-getriebenen Entwicklungswerkzeugen ist die Erstellung von Anwendungen zugänglicher als je zuvor. +Wir möchten es so einfach wie möglich machen, die von dir erstellten Apps — ob schnell prototypisiert oder durchdacht entwickelt — selbstbewusst in die Welt zu bringen und dort zu teilen. + +Neben schnellem Prototyping und Entwicklung möchten wir es Nutzern ermöglichen, ihre +mit KI entwickelten Apps einfach mit anderen zu teilen und in Produktionsumgebungen bereitzustellen, ohne sich +mit komplexen Bereitstellungsprozessen oder Konfigurationen auseinandersetzen zu müssen. + +Ob du eine kleine geschäftliche App oder eine komplexere Anwendung mit KI-getriebener Entwicklung erstellst — dieser Guide hilft dir, +deine App von deinem lokalen Rechner (oder einer Cloud-basierten IDE) mit minimalem Aufwand in die Welt zu bringen. + +Eine App bereitzustellen ist spannend — und es lohnt sich, das durchdacht zu tun. Compliance, Datenschutz, Sicherheit und operative +Verantwortung sind wichtig. Wir empfehlen dir, dich an unsere Community zu wenden, wenn du Fragen hast. + +## Überblick über die mit KI entwickelte App-Landschaft {#ueberblick-ki-entwickelte-app-landschaft} + +Apps, die durch KI-getriebene Entwicklung entstehen, sind leicht zu erstellen, und es gibt eine Vielzahl von Bereitstellungsoptionen. + +Verschiedene Plattformen bieten unterschiedliche Vorteile und Nachteile. Anbieter wie Replit und Lovable priorisieren Entwicklungsgeschwindigkeit +und Benutzerfreundlichkeit mit ihren speziellen Projektvorlagen, Buildsystemen und Bereitstellungspipelines. Dieser Komfort +geht mit einem Nachteil einher: Eine spätere Migration auf eine andere Plattform kann Nacharbeit erfordern. +Andererseits erhältst du einen schnellen Weg in die Produktion mit integrierten Werkzeugen und Support. + +Plattformen wie GitHub und mittwald bieten dagegen flexiblere und standardisierte +Bereitstellungsoptionen, die leicht an verschiedene Umgebungen angepasst werden können. + +Durch die Verwendung von GitHub als zentrales Repository für deine mit KI entwickelte App kannst du +eine klare Historie von Änderungen bewahren, mit anderen zusammenarbeiten und in verschiedene Plattformen +bereitstellen, ohne an ein spezifisches Vendor-Ökosystem gebunden zu sein. + +Dieser Ansatz bietet dir größere Freiheit und Kontrolle über die Bereitstellung deiner App, +während du weiterhin von der Leichtigkeit und Geschwindigkeit der KI-getriebenen Entwicklung profitierst. + +## GitHub ist unser Anker {#github-ist-unser-anker} + +Wenn wir nach GitHub exportieren können, haben wir gute Chancen, überall zu deployen. + +Die meisten Plattformen unterstützen GitHub als Quelle für die Bereitstellung. Ein gut strukturiertes +GitHub-Repository ermöglicht bessere Zusammenarbeit, Versionskontrolle und Integration +mit verschiedenen Bereitstellungstools und -diensten. Falls GitHub nicht die bevorzugte Git-Plattform ist, +gelten die gleichen Prinzipien für jeden anderen Git-Hosting-Dienst mit ähnlichen Funktionen. + +Mit dem Moment, in dem wir unsere mit KI entwickelte App nach GitHub exportieren können, erschließen sich +vielfältige Bereitstellungsoptionen, darunter Continuous Integration und Continuous Deployment (CI/CD) +Pipelines und Containerisierung. + +Viele Tools bieten bidirektionale Synchronisierung mit GitHub. Das bedeutet, dass Änderungen im +GitHub-Repository automatisch in der Bereitstellungsumgebung sichtbar werden und umgekehrt. +Dies ermöglicht einen nahtloseren Entwicklungs- und Bereitstellungsprozess, +denn Entwickler können an ihrem Code in GitHub arbeiten und profitieren gleichzeitig +von einer live-Bereitstellungsumgebung. + +Die Exportqualität variiert, daher solltest du zuerst lokal testen. Ein gut strukturierter Export mit allem notwendigen Code, +Konfiguration und Build-Dateien macht Bereitstellung und Wartung viel einfacher. +Ein unvollständiger Export erfordert möglicherweise Nacharbeit bei der Bereitstellung oder Wartung und kann +Probleme mit Versionskontrolle und Zusammenarbeit verursachen. + +## Prinzipien und Grenzen von Zero-Conf-Deployments {#prinzipien-und-grenzen-zero-conf-deployments} + +Da die meisten Plattformen mit benutzerdefinierten Pipelines und Konfigurationen bereitstellen, +müssen wir einen gemeinsamen Nenner für Zero-Conf-Deployment definieren. +In diesem Kontext bedeutet Zero-Conf-Deployment, dass wir den exportierten Code von GitHub nehmen +und ihn auf einer Plattform bereitstellen können, ohne manuelle Änderungen oder Konfigurationen vornehmen zu müssen. + +Mit anderen Worten: Endnutzer sollten ihre mit KI entwickelte App mit minimalem Setup bereitstellen können, +idealer Weise nur durch das Verbinden ihres GitHub-Repositorys mit einer Bereitstellungsplattform, die +Zero-Conf-Deployment unterstützt. + +Unglücklicherweise unterstützen nicht alle Plattformen Zero-Conf-Deployment, und selbst die, die es tun, können +Einschränkungen oder Kompromisse haben. Beispielsweise können einige Plattformen spezifische Dateistrukturen, +Konfigurationsdateien oder Build-Prozesse erfordern, die nicht damit kompatibel sind, +wie mit KI entwickelte Apps exportiert werden. + +Mit anderen Worten: Während Zero-Conf-Deployment ein ideales Ziel ist, ist es in der Praxis nicht immer erreichbar, +und Nutzer müssen möglicherweise manuelle Anpassungen oder Konfigurationen vornehmen. + +Eine gute Praktik, um exportierten Code auf Zero-Conf-Kompatibilität zu überprüfen, ist es, ihn lokal +mit einem Tool wie Docker oder einem lokalen Entwicklungsserver bereitzustellen, bevor du ihn auf einer Cloud-Plattform bereitstellst. +Dies kann dabei helfen, Probleme oder fehlende Komponenten zu identifizieren, die vor der Bereitstellung behoben werden müssen. + +## Tipps und Tricks auf dem Weg zu Zero-Conf-Deployment {#tipps-und-tricks-zero-conf-deployment} + +Während der Entwicklung können wir bestimmte Praktiken befolgen, um die Chancen auf Zero-Conf-Deployment zu verbessern. + +Halte den Stack klein: Je mehr Abhängigkeiten und Services deine App benötigt, desto komplexer wird der Bereitstellungsprozess. + +Nutze Standard-Tools und -Konfigurationen: Das Befolgen von weit verbreiteten Tools und Konfigurationen kann die Kompatibilität +mit verschiedenen Bereitstellungsplattformen erhöhen. + +Dokumentiere die Anforderungen und Abhängigkeiten deiner App klar: Dies kann anderen helfen zu verstehen, was für eine +erfolgreiche Bereitstellung der App erforderlich ist, und kann auch bei der Fehlerbehebung helfen. + +Überprüfe bewährte Verfahren für Sicherheit und Datenschutz: Eine App, die Sicherheits- und Datenschutzrichtlinien befolgt, +kann Probleme bei der Bereitstellung und im laufenden Betrieb verhindern. Vermeiden hartcodierte Secrets, verwende Umgebungsvariablen, +und überprüfe deine Abhängigkeiten regelmäßig auf Sicherheitslücken. + +Bereitstellungs-Checkliste: +- [ ] App läuft lokal ohne Fehler +- [ ] Alle Secrets/Keys sind nicht in deinem Code! +- [ ] README erklärt Setup & Verwendung +- [ ] Build-/Export-Skripte funktionieren +- [ ] App in einem Browser/Incognito-Fenster getestet +- [ ] Backups: Speichere eine Kopie deines Projekts! +- [ ] Wähle einen zuverlässigen Host, der deine Anforderungen erfüllt +- [ ] Teile den Link mit einem Freund — hole Feedback ein +- [ ] Feiern dein erstes Deployment! 🎉 + +## Zero-Conf-Deployment bei mittwald {#zero-conf-deployment-bei-mittwald} + +mittwald bietet eine Zero-Conf-Deployment-Option für mit KI entwickelte Apps, +die es Nutzern ermöglicht, ihre Apps direkt von GitHub mit minimalem Setup bereitzustellen. + +Gegenwärtig gibt es zwei Hauptwege für das Zero-Conf-Deployment von mit KI entwickelten Apps: +- Manuell über die mittwald-CLI +- Automatisiert über GitHub Action + +Der empfohlene Ansatz ist, mit der manuellen CLI-Bereitstellung zu beginnen, um den +Prozess zu verstehen, und dann zur Automatisierung mit GitHub Actions für einen strafferen +und effizienter Bereitstellungs-Workflow überzugehen. + +Eine separate Erweiterung für mStudio ist in Entwicklung, die den +Bereitstellungsprozess durch eine integrierte Erfahrung in der Entwicklungsumgebung weiter vereinfacht. + +## Schnellstart-Anleitung zum Zero-Conf-Deployment von mit KI entwickelten Apps {#schnellstart-zero-conf-deployment-ki-entwickelte-apps} + +Voraussetzungen: +- Eine mit KI entwickelte App mit einem GitHub-Repository +- Ein mittwald-Hosting-Konto +- Grundlegendes Verständnis von Git und GitHub +- mittwald-CLI installiert und konfiguriert + +Manuell durchzuführende Schritte: +1. Bereite deine mit KI entwickelte App für die Bereitstellung vor: Vergewissere dich, dass sie lokal läuft und dass alle Abhängigkeiten installiert sind. + +```shellsession +user@local $ git clone https://github.com//.git +user@local $ cd +``` + +2. Stelle sicher, dass dein lokales Repository mit GitHub synchron ist und dass deine Änderungen committed und gepusht sind. + +```shellsession +user@local $ git pull +user@local $ git status +``` + +3. Verwende in deinem App-Ordner die mittwald-CLI, um ein Projekt zu erstellen und das Bereitstellungskommando auszuführen. + +```shellsession +user@local $ mw project create --description= --update-context +user@local $ mw experimental deploy +``` + +Die erste Bereitstellung dauert einige Minuten, während die App gebaut und die Hosting-Umgebung eingerichtet wird. +Sobald die Bereitstellung abgeschlossen ist, kannst du deine App über die bereitgestellte URL aufrufen. + +Teste deine App in einem Browser, und falls du Probleme hast, überprüfe die Logs und Konfiguration zur Fehlerbehebung. + +Nach erfolgreicher Bereitstellung kannst du eine GitHub Action einrichten, um zukünftige Bereitstellungen zu automatisieren, wenn du +Änderungen in dein Repository pushst. Nutze Git-Tags, um Releases und Rollbacks effektiv zu verwalten. + +Weiterführende Guides für tiefergehendes Setup: + +- Für containergestützte CI/CD mit GitHub Actions, siehe [Deployment von containerisierten Anwendungen mit GitHub Actions](/docs/v2/guides/deployment/container-actions/). +- Für erweiterte Bereitstellungs-Workflows und CI-Beispiele, siehe [Application Deployment mit deployer](/docs/v2/guides/deployment/deployer/). +- Für Container-Konzepte, Stack-Dateien und Registry-Setup, siehe [Container](/docs/v2/platform/workloads/containers/). +- Für deklarative Stack-Bereitstellungsbefehle, siehe [mw stack Befehlsreferenz](/docs/v2/cli/reference/stack/). + +## Vorwärts gehen: Best Practices für Erfolg {#vorwaerts-best-practices-fuer-erfolg} + +Während du dich auf die Bereitstellung vorbereitest, berücksichtige diese Praktiken, die Apps zum Erfolg bringen: + +- **Sicherheit und Datenschutz sind wichtig.** Entferne hartcodierte Secrets, verwende Umgebungsvariablen und halte Abhängigkeiten aktuell. +Diese Praktiken sind unkompliziert und machen deine App zuverlässiger. +- **Teste früh.** Stelle lokal bereit, teile mit Freunden und hole dir Feedback ein, bevor du live gehst. +- **Community ist hier.** Unser mittwald Discord Server ist ein großartiger Ort, um Fragen zu stellen, deine Projekte zu teilen, +und von anderen Entwicklern zu lernen. +- **Eine Größe passt nicht für alle.** Zero-Conf-Deployment funktioniert großartig für viele mit KI entwickelte Apps. Falls deine App spezifische Anforderungen hat — komplexe +Datenbanken, benutzerdefinierte Infrastruktur oder Compliance-Anforderungen — das ist kein Problem. Plane entsprechend und +zögere nicht, uns um Orientierung zu bitten. + +Du hast etwas Cooles gebaut. Starte es, lerne daraus und iteriere weiter. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/vibecoded_apps.mdx b/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/vibecoded_apps.mdx deleted file mode 100644 index 92d93bf0a..000000000 --- a/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/vibecoded_apps.mdx +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Deployment von vibe coded apps -sidebar_label: Vibe coded apps -tags: - - Deployment - - GitHub - - Apps -description: Struktur und Schnellstart zum Deployen von vibe coded apps mit einem Zero-Conf-Ansatz ---- - -## Einführung / Motivation {#einfuehrung-motivation} - -Warum wollen wir vibe coded apps überhaupt produktiv ausrollen? - -- TODO: Produkt- und Business-Motivation definieren -- TODO: erwartete Geschwindigkeits- und Lernvorteile beschreiben -- TODO: klären, wann Vibecoding sinnvoll ist und wann nicht - -## Überblick über die Vibecoding-App-Landschaft {#ueberblick-vibecoding-app-landschaft} - -Apps sind schnell erstellt, aber viele Anbieter versuchen dich über proprietäre Deployments zu binden. - -- TODO: typische Plattformtypen und Lock-in-Mechanismen einordnen -- TODO: Migrationsaufwand und langfristige Kosten skizzieren -- TODO: Hosted-Komfort und Portabilität gegenüberstellen - -## GitHub ist unser Anker {#github-ist-unser-anker} - -Wenn wir nach GitHub exportieren können, haben wir gute Chancen, überall zu deployen. - -- TODO: erläutern, warum Git-Historie und Repository-Eigentum wichtig sind -- TODO: minimale Export-Anforderungen definieren (Code, Konfig, Build-Dateien) -- TODO: Stolperfallen bei unvollständigen oder einseitigen Exports benennen - -## Prinzipien und Grenzen von Zero-Conf-Deployments {#prinzipien-und-grenzen-zero-conf-deployments} - -- TODO: definieren, was Zero Conf in diesem Guide bedeutet -- TODO: technische Grenzen und Trade-offs erklären -- TODO: Erwartungsmanagement für Fälle mit manuellem Setup - -## Tipps und Tricks auf dem Weg zu Zero-Conf-Deployment {#tipps-und-tricks-zero-conf-deployment} - -- TODO: Coding-Patterns für bessere Deploybarkeit -- TODO: Hygiene bei Repository und Umgebungsvariablen -- TODO: praktische Checkliste vor dem ersten Deployment - -## Zero-Conf-Deployment bei mittwald {#zero-conf-deployment-bei-mittwald} - -mw CLI, GitHub Action, Extension. - -- TODO: kurze Übersicht über jeden Weg -- TODO: Entscheidungskriterien je nach Team-Reifegrad -- TODO: weiterführende Guides und Doku verlinken - -## Schnellstart für Zero-Conf-Deployment von vibe coded apps {#schnellstart-zero-conf-deployment-vibe-coded-apps} - -- TODO: Voraussetzungen -- TODO: lokales Projekt vorbereiten -- TODO: GitHub-Setup -- TODO: erstes Deployment mit mittwald -- TODO: Verifikation und Rollback-Grundlagen - -## Schlusswort und Warnhinweise {#schlusswort-und-warnhinweise} - -Datenschutz, Sicherheit und operative Verantwortung. - -- TODO: Datenschutz-Checkliste für Source und Telemetrie -- TODO: Security-Baseline (Secrets, Dependency-Hygiene, Least Privilege) -- TODO: operative Warnhinweise und Eskalationsweg From 6d0e877416ed38f1b4afeeaf6a1b64b92bd0e28f Mon Sep 17 00:00:00 2001 From: Lars Bergmann Date: Wed, 27 May 2026 13:46:28 +0200 Subject: [PATCH 08/11] adjust anchor ids --- .../guides/deployment/ai_developed_apps.mdx | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx b/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx index 8902e0feb..e2eeb31c1 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx +++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx @@ -8,7 +8,7 @@ tags: description: Struktur und Schnellstart zum Deployen von mit KI entwickelten Apps mit einem Zero-Conf-Ansatz --- -## Einführung / Motivation {#einfuehrung-motivation} +## Einführung / Motivation {#introduction-motivation} Mit rasant voranschreitenden KI-getriebenen Entwicklungswerkzeugen ist die Erstellung von Anwendungen zugänglicher als je zuvor. Wir möchten es so einfach wie möglich machen, die von dir erstellten Apps — ob schnell prototypisiert oder durchdacht entwickelt — selbstbewusst in die Welt zu bringen und dort zu teilen. @@ -23,7 +23,7 @@ deine App von deinem lokalen Rechner (oder einer Cloud-basierten IDE) mit minima Eine App bereitzustellen ist spannend — und es lohnt sich, das durchdacht zu tun. Compliance, Datenschutz, Sicherheit und operative Verantwortung sind wichtig. Wir empfehlen dir, dich an unsere Community zu wenden, wenn du Fragen hast. -## Überblick über die mit KI entwickelte App-Landschaft {#ueberblick-ki-entwickelte-app-landschaft} +## Überblick über die mit KI entwickelte App-Landschaft {#ai-developed-app-landscape-overview} Apps, die durch KI-getriebene Entwicklung entstehen, sind leicht zu erstellen, und es gibt eine Vielzahl von Bereitstellungsoptionen. @@ -42,7 +42,7 @@ bereitstellen, ohne an ein spezifisches Vendor-Ökosystem gebunden zu sein. Dieser Ansatz bietet dir größere Freiheit und Kontrolle über die Bereitstellung deiner App, während du weiterhin von der Leichtigkeit und Geschwindigkeit der KI-getriebenen Entwicklung profitierst. -## GitHub ist unser Anker {#github-ist-unser-anker} +## GitHub ist unser Anker {#github-is-our-anchor} Wenn wir nach GitHub exportieren können, haben wir gute Chancen, überall zu deployen. @@ -66,7 +66,7 @@ Konfiguration und Build-Dateien macht Bereitstellung und Wartung viel einfacher. Ein unvollständiger Export erfordert möglicherweise Nacharbeit bei der Bereitstellung oder Wartung und kann Probleme mit Versionskontrolle und Zusammenarbeit verursachen. -## Prinzipien und Grenzen von Zero-Conf-Deployments {#prinzipien-und-grenzen-zero-conf-deployments} +## Prinzipien und Grenzen von Zero-Conf-Deployments {#principles-and-limits-of-zero-conf-deployments} Da die meisten Plattformen mit benutzerdefinierten Pipelines und Konfigurationen bereitstellen, müssen wir einen gemeinsamen Nenner für Zero-Conf-Deployment definieren. @@ -89,7 +89,7 @@ Eine gute Praktik, um exportierten Code auf Zero-Conf-Kompatibilität zu überpr mit einem Tool wie Docker oder einem lokalen Entwicklungsserver bereitzustellen, bevor du ihn auf einer Cloud-Plattform bereitstellst. Dies kann dabei helfen, Probleme oder fehlende Komponenten zu identifizieren, die vor der Bereitstellung behoben werden müssen. -## Tipps und Tricks auf dem Weg zu Zero-Conf-Deployment {#tipps-und-tricks-zero-conf-deployment} +## Tipps und Tricks auf dem Weg zu Zero-Conf-Deployment {#tips-and-tricks-zero-conf-deployment} Während der Entwicklung können wir bestimmte Praktiken befolgen, um die Chancen auf Zero-Conf-Deployment zu verbessern. @@ -116,7 +116,7 @@ Bereitstellungs-Checkliste: - [ ] Teile den Link mit einem Freund — hole Feedback ein - [ ] Feiern dein erstes Deployment! 🎉 -## Zero-Conf-Deployment bei mittwald {#zero-conf-deployment-bei-mittwald} +## Zero-Conf-Deployment bei mittwald {#zero-conf-deployment-at-mittwald} mittwald bietet eine Zero-Conf-Deployment-Option für mit KI entwickelte Apps, die es Nutzern ermöglicht, ihre Apps direkt von GitHub mit minimalem Setup bereitzustellen. @@ -132,7 +132,7 @@ und effizienter Bereitstellungs-Workflow überzugehen. Eine separate Erweiterung für mStudio ist in Entwicklung, die den Bereitstellungsprozess durch eine integrierte Erfahrung in der Entwicklungsumgebung weiter vereinfacht. -## Schnellstart-Anleitung zum Zero-Conf-Deployment von mit KI entwickelten Apps {#schnellstart-zero-conf-deployment-ki-entwickelte-apps} +## Schnellstart-Anleitung zum Zero-Conf-Deployment von mit KI entwickelten Apps {#quickstart-zero-conf-deployment-ai-developed-apps} Voraussetzungen: - Eine mit KI entwickelte App mit einem GitHub-Repository @@ -177,7 +177,7 @@ Weiterführende Guides für tiefergehendes Setup: - Für Container-Konzepte, Stack-Dateien und Registry-Setup, siehe [Container](/docs/v2/platform/workloads/containers/). - Für deklarative Stack-Bereitstellungsbefehle, siehe [mw stack Befehlsreferenz](/docs/v2/cli/reference/stack/). -## Vorwärts gehen: Best Practices für Erfolg {#vorwaerts-best-practices-fuer-erfolg} +## Vorwärts gehen: Best Practices für Erfolg {#moving-forward-best-practices} Während du dich auf die Bereitstellung vorbereitest, berücksichtige diese Praktiken, die Apps zum Erfolg bringen: From 45619152f6ceacfd205f82374f883bb444205499 Mon Sep 17 00:00:00 2001 From: Lars Bergmann Date: Wed, 27 May 2026 14:10:39 +0200 Subject: [PATCH 09/11] Grammar grind --- .../current/guides/deployment/ai_developed_apps.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx b/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx index e2eeb31c1..9bdd51aaa 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx +++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx @@ -102,7 +102,7 @@ Dokumentiere die Anforderungen und Abhängigkeiten deiner App klar: Dies kann an erfolgreiche Bereitstellung der App erforderlich ist, und kann auch bei der Fehlerbehebung helfen. Überprüfe bewährte Verfahren für Sicherheit und Datenschutz: Eine App, die Sicherheits- und Datenschutzrichtlinien befolgt, -kann Probleme bei der Bereitstellung und im laufenden Betrieb verhindern. Vermeiden hartcodierte Secrets, verwende Umgebungsvariablen, +kann Probleme bei der Bereitstellung und im laufenden Betrieb verhindern. Vermeide hartcodierte Secrets, verwende Umgebungsvariablen, und überprüfe deine Abhängigkeiten regelmäßig auf Sicherheitslücken. Bereitstellungs-Checkliste: @@ -114,7 +114,7 @@ Bereitstellungs-Checkliste: - [ ] Backups: Speichere eine Kopie deines Projekts! - [ ] Wähle einen zuverlässigen Host, der deine Anforderungen erfüllt - [ ] Teile den Link mit einem Freund — hole Feedback ein -- [ ] Feiern dein erstes Deployment! 🎉 +- [ ] Feiere dein erstes Deployment! 🎉 ## Zero-Conf-Deployment bei mittwald {#zero-conf-deployment-at-mittwald} From 344f67f3ea1c75cbe7d46a3407121284d6c09ba7 Mon Sep 17 00:00:00 2001 From: Lars Bergmann Date: Wed, 27 May 2026 14:34:44 +0200 Subject: [PATCH 10/11] Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Signed-off-by: Lars Bergmann --- docs/guides/deployment/ai_developed_apps.mdx | 4 ++-- .../current/guides/deployment/ai_developed_apps.mdx | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/guides/deployment/ai_developed_apps.mdx b/docs/guides/deployment/ai_developed_apps.mdx index dc7b19265..51b1394f2 100644 --- a/docs/guides/deployment/ai_developed_apps.mdx +++ b/docs/guides/deployment/ai_developed_apps.mdx @@ -121,9 +121,9 @@ Deployment checklist: mittwald offers a zero-conf deployment option for AI-developed apps, allowing users to deploy their apps directly from GitHub with minimal setup. -In the present, two main paths for zero-conf deployment of AI-developed apps are present: +Currently, there are two main paths for zero-conf deployment of AI-developed apps: - Manually via mittwald CLI -- Automated via GitHub Action +- Automated via GitHub Actions The recommended approach is to start with the manual CLI deployment to understand the process and then move towards automation with GitHub Actions for a more streamlined diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx b/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx index 9bdd51aaa..dbe223e0d 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx +++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx @@ -74,7 +74,7 @@ In diesem Kontext bedeutet Zero-Conf-Deployment, dass wir den exportierten Code und ihn auf einer Plattform bereitstellen können, ohne manuelle Änderungen oder Konfigurationen vornehmen zu müssen. Mit anderen Worten: Endnutzer sollten ihre mit KI entwickelte App mit minimalem Setup bereitstellen können, -idealer Weise nur durch das Verbinden ihres GitHub-Repositorys mit einer Bereitstellungsplattform, die +idealerweise nur durch das Verbinden ihres GitHub-Repositorys mit einer Bereitstellungsplattform, die Zero-Conf-Deployment unterstützt. Unglücklicherweise unterstützen nicht alle Plattformen Zero-Conf-Deployment, und selbst die, die es tun, können @@ -123,7 +123,7 @@ die es Nutzern ermöglicht, ihre Apps direkt von GitHub mit minimalem Setup bere Gegenwärtig gibt es zwei Hauptwege für das Zero-Conf-Deployment von mit KI entwickelten Apps: - Manuell über die mittwald-CLI -- Automatisiert über GitHub Action +- Automatisiert über GitHub Actions Der empfohlene Ansatz ist, mit der manuellen CLI-Bereitstellung zu beginnen, um den Prozess zu verstehen, und dann zur Automatisierung mit GitHub Actions für einen strafferen @@ -184,7 +184,7 @@ Während du dich auf die Bereitstellung vorbereitest, berücksichtige diese Prak - **Sicherheit und Datenschutz sind wichtig.** Entferne hartcodierte Secrets, verwende Umgebungsvariablen und halte Abhängigkeiten aktuell. Diese Praktiken sind unkompliziert und machen deine App zuverlässiger. - **Teste früh.** Stelle lokal bereit, teile mit Freunden und hole dir Feedback ein, bevor du live gehst. -- **Community ist hier.** Unser mittwald Discord Server ist ein großartiger Ort, um Fragen zu stellen, deine Projekte zu teilen, +- **Community ist hier.** Unser mittwald Discord-Server ist ein großartiger Ort, um Fragen zu stellen, deine Projekte zu teilen, und von anderen Entwicklern zu lernen. - **Eine Größe passt nicht für alle.** Zero-Conf-Deployment funktioniert großartig für viele mit KI entwickelte Apps. Falls deine App spezifische Anforderungen hat — komplexe Datenbanken, benutzerdefinierte Infrastruktur oder Compliance-Anforderungen — das ist kein Problem. Plane entsprechend und From 3db6ef4861b2f837a9c59d9232650228b845bfc8 Mon Sep 17 00:00:00 2001 From: Lars Bergmann Date: Thu, 28 May 2026 13:24:11 +0200 Subject: [PATCH 11/11] grind off some edges --- docs/guides/deployment/ai_developed_apps.mdx | 14 +++++++++----- .../guides/deployment/ai_developed_apps.mdx | 14 +++++++++----- 2 files changed, 18 insertions(+), 10 deletions(-) diff --git a/docs/guides/deployment/ai_developed_apps.mdx b/docs/guides/deployment/ai_developed_apps.mdx index 51b1394f2..91395404a 100644 --- a/docs/guides/deployment/ai_developed_apps.mdx +++ b/docs/guides/deployment/ai_developed_apps.mdx @@ -32,7 +32,7 @@ and ease of use with their specific project templates, build systems, and deploy comes with a trade-off: moving your app to another platform later may require rework. On the other hand, you get a fast path to production with integrated tools and support. -Platforms like GitHub and mittwald, on the other hand, offer more standard and flexible +Platforms like GitHub and mittwald, however, offer more standard and flexible deployment options that can be easily adapted to different environments. By using GitHub as a central repository for your AI-developed app, you can maintain @@ -61,12 +61,14 @@ and vice versa. This allows for a more seamless development and deployment proce as developers can work on their code in GitHub while still having the benefits of a live deployment environment. +## Principles and limits of zero-conf deployments {#principles-and-limits-of-zero-conf-deployments} + +:::warning Export quality varies, so test locally first. A well-structured export that includes all necessary code, configuration, and build files makes deployment and maintenance much easier. A partial or incomplete export may require rework during deployment or maintenance, and can create issues with version control and collaboration. - -## Principles and limits of zero-conf deployments {#principles-and-limits-of-zero-conf-deployments} +::: As most platforms deploy with custom pipelines and configurations, we need to define a common denominator for zero-conf deployment. @@ -85,11 +87,13 @@ the way AI-developed apps are exported. In other words: while zero-conf deployment is an ideal goal, it may not always be achievable in practice, and users may need to be prepared to make some manual adjustments or configurations in certain cases. +## Tips and tricks to work towards zero-conf deployment {#tips-and-tricks-zero-conf-deployment} + +:::tip A good practice to check exported code for zero-conf compatibility is to try deploying it locally using a tool like Docker or a local development server before attempting to deploy it to a cloud platform. This can help identify any issues or missing components that may need to be addressed before deployment. - -## Tips and tricks to work towards zero-conf deployment {#tips-and-tricks-zero-conf-deployment} +::: During development, we can follow certain practices to improve the chances of achieving zero-conf deployment. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx b/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx index dbe223e0d..55cd1b9da 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx +++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/deployment/ai_developed_apps.mdx @@ -61,12 +61,14 @@ Dies ermöglicht einen nahtloseren Entwicklungs- und Bereitstellungsprozess, denn Entwickler können an ihrem Code in GitHub arbeiten und profitieren gleichzeitig von einer live-Bereitstellungsumgebung. +## Prinzipien und Grenzen von Zero-Conf-Deployments {#principles-and-limits-of-zero-conf-deployments} + +:::warning Die Exportqualität variiert, daher solltest du zuerst lokal testen. Ein gut strukturierter Export mit allem notwendigen Code, Konfiguration und Build-Dateien macht Bereitstellung und Wartung viel einfacher. Ein unvollständiger Export erfordert möglicherweise Nacharbeit bei der Bereitstellung oder Wartung und kann Probleme mit Versionskontrolle und Zusammenarbeit verursachen. - -## Prinzipien und Grenzen von Zero-Conf-Deployments {#principles-and-limits-of-zero-conf-deployments} +::: Da die meisten Plattformen mit benutzerdefinierten Pipelines und Konfigurationen bereitstellen, müssen wir einen gemeinsamen Nenner für Zero-Conf-Deployment definieren. @@ -85,11 +87,13 @@ wie mit KI entwickelte Apps exportiert werden. Mit anderen Worten: Während Zero-Conf-Deployment ein ideales Ziel ist, ist es in der Praxis nicht immer erreichbar, und Nutzer müssen möglicherweise manuelle Anpassungen oder Konfigurationen vornehmen. +## Tipps und Tricks auf dem Weg zu Zero-Conf-Deployment {#tips-and-tricks-zero-conf-deployment} + +:::tip Eine gute Praktik, um exportierten Code auf Zero-Conf-Kompatibilität zu überprüfen, ist es, ihn lokal mit einem Tool wie Docker oder einem lokalen Entwicklungsserver bereitzustellen, bevor du ihn auf einer Cloud-Plattform bereitstellst. Dies kann dabei helfen, Probleme oder fehlende Komponenten zu identifizieren, die vor der Bereitstellung behoben werden müssen. - -## Tipps und Tricks auf dem Weg zu Zero-Conf-Deployment {#tips-and-tricks-zero-conf-deployment} +::: Während der Entwicklung können wir bestimmte Praktiken befolgen, um die Chancen auf Zero-Conf-Deployment zu verbessern. @@ -177,7 +181,7 @@ Weiterführende Guides für tiefergehendes Setup: - Für Container-Konzepte, Stack-Dateien und Registry-Setup, siehe [Container](/docs/v2/platform/workloads/containers/). - Für deklarative Stack-Bereitstellungsbefehle, siehe [mw stack Befehlsreferenz](/docs/v2/cli/reference/stack/). -## Vorwärts gehen: Best Practices für Erfolg {#moving-forward-best-practices} +## Auf zum Erfolg: Best Practices {#moving-forward-best-practices} Während du dich auf die Bereitstellung vorbereitest, berücksichtige diese Praktiken, die Apps zum Erfolg bringen: