# :material-book: Guides

Instructions and explanations for practical Implementations ordered by Topics.

## Tutorials

**Learning-oriented adventures with a hands-on experience.**

<div class="grid cards" markdown>

-   :material-clock-fast:{ .lg .middle } __Set up in 15 minutes__

    ---

    Create your own clan and get everything
    running in minutes

    [:octicons-arrow-right-24: Getting started](../getting-started/index.md)

-   :fontawesome-solid-user-group:{ .lg .middle } __Authoring Modules__

    ---

    Create clanModules that can be reused by the community.

    [:octicons-arrow-right-24: Authoring clanModules](../clanmodules/index.md)

</div>

## Guides

**How-to Guides for achieving a certain goal or solving a specific issue.**

<div class="grid cards" markdown>

-   [Machines](./adding-machines.md)

    ---

    Learn how Clan automatically includes machines and Nix files.

-   [Secrets](./secrets.md)

    ---

    Learn how to manage secrets.

-   [Inventory](./inventory.md)

    ---

    Clan's declaration format for running **services** on one or multiple **machines**.

-   [Flake-parts](./flake-parts.md)

    ---

    Use clan with [https://flake-parts.dev]()

-   [Contribute](./contribute.md)

    ---

    Discover how to set up a development environment to contribute to Clan!

</div>