# Introduction

[Kubails](https://github.com/DevinSit/kubails) is a highly opinionated framework for enabling rapid deployment and prototyping of Docker-based web services.

That is, if you're developing a web app, **Kubails** makes a bunch of tooling and infrastructure decisions for you so that you can get your app deployed in **less than an hour**. Then you can start iterating quickly while being supported by modern development comforts like **repeatable environments**, **true CI/CD**, and **per branch deployments**.

So if this sounds like the sort of thing that would be helpful for your project, then try out Kubails and get to building *now*.

If you have any questions about the project, feel free to check the [FAQ](/faq.md).

{% hint style="warning" %}
Kubails is still **alpha** software.

While the underlying technologies are mostly production-ready, using **Kubails** for production projects is certainly at **your own risk**!
{% endhint %}

## Features

* **Fast initial setup**: Get deployed and developing in less than an hour.
* **Opinionated project architecture**: Worry less about deciding between one person's cloud or another.
* **Robust infrastructure management**: With Terraform and Helm, everything is just configuration as code.
* **Centralized configuration**: `kubails.json` is your entrypoint to keeping Terraform, Helm, and everything else in sync.
* **Scale as you grow**: By the power of *The Cloud™* and Kubernetes, you can scale as much as you have money.
* **Modern developer experience**: Between Docker and per branch deployments, you can be sure that what works in one place works everywhere.

## Get Started

Follow the [Getting Started guide](/gettingstarted.md) to get your project up and running in the next hour.

## Learn about Kubails

While Kubails makes a lot of decisions for you and tries to automate away a lot of the drudgery, that doesn't mean you shouldn't understand the underlying concepts and technologies.

Here are some guides that explain each piece of Kubails and what technologies are used to make it happen:

1. [Folder Structure](/topics/folderstructure.md)
2. [Services](/topics/services.md)
3. [Infrastructure](/topics/infrastructure.md)
4. [CI/CD and Per Branch Deployments](/topics/perbranchdeployments.md)
5. [Project Configuration](/topics/projectconfiguration.md)
6. [Manifests](/topics/manifests.md)
7. [Make as a Task Runner](/topics/maketaskrunner.md)

## References

Need to quickly look up what a configuration does or how a command works? Look no further.

1. [CLI Reference](/references/clireference.md)
2. [kubails.json Reference](/references/configreference.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kubails.com/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.