> For the complete documentation index, see [llms.txt](https://docs.sacruda.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sacruda.nl/developers/welcome.md).

# Sacruda Developers

Welcome to the documentation for writing Sacruda applications

<a href="https://github.com/Sacruda/v7" class="button secondary" data-icon="code-branch">GitHub repository</a><a href="https://os.sacruda.nl/" class="button secondary" data-icon="power-off">Boot Sacruda release</a><a class="button secondary" data-icon="rectangle-beta">Boot ArcOS beta</a>

&#x20;

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><h4><i class="fa-rocket" style="color:$primary;">:rocket:</i></h4></td><td><strong>Getting started</strong></td><td>Follow this guide to create your first app</td><td><a href="https://docs.sacruda.nl/developers/getting-started/intro.md">Getting started</a></td><td><a href="https://1381638529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fajtj78B3126gLqEeZFKg%2Fuploads%2FjXINyklFMkGJb5YQ9Tds%2Fno-code.jpg?alt=media&amp;token=b2dde28b-1793-49af-9db7-8046b48113a3">no-code.jpg</a></td></tr><tr><td><h4><i class="fa-brackets-curly" style="color:$primary;">:brackets-curly:</i></h4></td><td><strong>Your app's code</strong></td><td>Learn about the structure of Sacruda third-party applications</td><td><a href="https://docs.sacruda.nl/developers/your-apps-code/the-basics.md">The basics</a></td><td><a href="https://1381638529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fajtj78B3126gLqEeZFKg%2Fuploads%2Fd8rxKSvhrTlRIGUtUwX7%2Fhosted.jpg?alt=media&amp;token=191342aa-6e60-4a4b-86dd-cdc819c89783">hosted.jpg</a></td></tr><tr><td><h4><i class="fa-webhook" style="color:$primary;">:webhook:</i></h4></td><td><strong>Sacruda APIs</strong></td><td>Read about the system's internal APIs you can use for your application</td><td><a href="https://docs.sacruda.nl/developers/sacruda-apis/process-handler.md">Sacruda APIs</a></td><td><a href="https://1381638529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fajtj78B3126gLqEeZFKg%2Fuploads%2Fzu0mXhuhlLf1yeVGQX3A%2Fapi-reference.jpg?alt=media&amp;token=c674db01-0f74-4600-b63a-a83e1397856b">api-reference.jpg</a></td></tr></tbody></table>

&#x20;

&#x20;

{% columns %}
{% column width="50%" %}

## Get started in minutes

Make your first application in under 5 minutes.

This quickstart walks through the basic setup: create an application, expand it using Sacruda's APIs, and package it for distribution.

{% hint style="info" %}
Each version of each application submitted to the app store is verified and approved by an authorized Sacruda system administrator. If you want to help with this process, scroll down and contact us to become part of the team.
{% endhint %}
{% endcolumn %}

{% column width="50%" %}
{% stepper %}
{% step %}

#### Your first app

Create your first application

<a href="https://docs.sacruda.nl/developers/getting-started/intro.md" class="button primary">Getting started guide</a>
{% endstep %}

{% step %}

#### Expand with the Sacruda APIs

For example, read a file from the Sacruda filesystem:

{% tabs %}
{% tab title="JavaScript" %}

```javascript
const path = util.join(this.workingDirectory, "file.txt");
const text = convert.arrayBufferToText(await fs.readFile(path));
```

{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### Publish to the app store

Package nd distribute your app so that people can install it on their systems.&#x20;

[Distribute your app](https://docs.sacruda.nl/developers/app-fundamentals/distribute-your-app.md)
{% endstep %}
{% endstepper %}
{% endcolumn %}
{% endcolumns %}

&#x20;

&#x20;

{% columns %}
{% column width="50%" %}

<figure><img src="https://1381638529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fajtj78B3126gLqEeZFKg%2Fuploads%2FNsX3EbypF8pKXMfoINKM%2Farcos-team-banner.png?alt=media&amp;token=87bab13f-3c82-4430-8df9-f345704901c5" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" valign="middle" %}

## Become part of the team

Are you interested in working on Sacruda itself, aside from your own applications? Chat with us! As a heads-up, we use Svelte, Typescript and a lot of CSS. The codebase is complicated, and nobody knows it fully, not even me.

<a href="mailto:support@sacruda.nl" class="button primary" data-icon="envelope-open">Contact us</a>&#x20;
{% endcolumn %}
{% endcolumns %}

<h2 align="center">Join the community and chat about Sacruda</h2>

<p align="center">Join our Discord community or create your first PR in just a few steps.</p>

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><h4><i class="fa-discord">:discord:</i></h4></td><td><strong>Discord community</strong></td><td>Join our Discord community to post questions, get help, and share resources with a us and our members.</td><td><a href="https://discord.gg/t5PaNP9dvg" class="button secondary">Join Discord</a></td><td><a href="https://1381638529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fajtj78B3126gLqEeZFKg%2Fuploads%2FsyeIf8n3A6sDX1KAK7mX%2Farcos-discord-banner.png?alt=media&amp;token=a366b140-8095-44c7-ba41-4190a4ff0c23">arcos-discord-banner.png</a></td></tr><tr><td><h4><i class="fa-github">:github:</i></h4></td><td><strong>GitHub</strong></td><td>View our GitHub repository to find out how Sacruda works down to the nitty gritty. It gets complicated <strong>fast.</strong></td><td><a href="https://github.com/Sacruda/v7" class="button secondary" data-icon="brackets-curly">View repository</a></td><td><a href="https://1381638529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fajtj78B3126gLqEeZFKg%2Fuploads%2F029McR2GmbObYTfeHgjB%2Farcos-github-banner.png?alt=media&amp;token=8570c6ee-4ccc-44fc-b936-9350156afadd">arcos-github-banner.png</a></td></tr></tbody></table>

&#x20;
