# Welcome

Aptivi Development Toolkit (ADT) is a drop-in replacement for the older legacy script-based development toolkit for your projects. It allows you to implement a set of functions, such as build, clean, and test functions, without having to write platform-specific scripts, with Python as the scripting language to achieve cross-platform support.

{% hint style="info" %}
If you're still planning to use the legacy script-based system, please consult [this manual](https://aptivi.gitbook.io/aptivi/build-and-pack-system/).
{% endhint %}

To get started, follow the instructions in the below page:

{% content-ref url="/pages/Sy1Qe4nbtGiaNaXoH3w7" %}
[Getting started](/aptivi/aptivi-development-toolkit/build-system/getting-started.md)
{% endcontent-ref %}

To learn more about the structure of the system, take a look here:

{% content-ref url="/pages/rJP5zr4yqTl2lFKiNVvn" %}
[Structure](/aptivi/aptivi-development-toolkit/build-system/structure.md)
{% endcontent-ref %}

***

## <mark style="color:$primary;">Release history</mark> <a href="#release-history" id="release-history"></a>

Below is the release history of the toolkit:

{% updates format="full" %}
{% update date="2026-05-10" %}

## <mark style="color:$primary;">v1.1.0.0</mark>

<mark style="color:green;">Added custom actions</mark>

<mark style="color:green;">Added listing remote branches</mark>

<mark style="color:yellow;">Attribute and type validation is now enforced</mark>

<mark style="color:yellow;">Push progress is now clearer</mark>

<mark style="color:yellow;">Fixed submodule changes causing git push fails</mark>

<mark style="color:yellow;">General improvements and bug fixes</mark>
{% endupdate %}

{% update date="2026-04-24" %}

## <mark style="color:$primary;">v1.0.2.0</mark>

<mark style="color:yellow;">Improved project handling</mark>

<mark style="color:yellow;">Help now shows for non-standalone actions when requested with</mark> <mark style="color:yellow;"></mark><mark style="color:yellow;">`-h`</mark>
{% endupdate %}

{% update date="2026-04-15" %}

## <mark style="color:$primary;">v1.0.1.0</mark>

<mark style="color:green;">Added</mark> <mark style="color:green;"></mark><mark style="color:green;">`-d`</mark> <mark style="color:green;"></mark><mark style="color:green;">or</mark> <mark style="color:green;"></mark><mark style="color:green;">`--dry`</mark> <mark style="color:green;"></mark><mark style="color:green;">options for creating commits</mark>

<mark style="color:green;">Added</mark> <mark style="color:green;"></mark><mark style="color:green;">`--self`</mark> <mark style="color:green;"></mark><mark style="color:green;">global parameter</mark>

<mark style="color:yellow;">Improved push output on completion</mark>
{% endupdate %}

{% update date="2026-03-05" %}

## <mark style="color:$primary;">v1.0.0.0</mark>

The initial version of the toolkit has been released!
{% endupdate %}
{% endupdates %}


---

# 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://aptivi.gitbook.io/aptivi/aptivi-development-toolkit/welcome.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.
