> For the complete documentation index, see [llms.txt](https://inklay.gitbook.io/inklay-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://inklay.gitbook.io/inklay-docs/custom-inklay-apps-claude-code.md).

# Custom Inklay Apps (Claude Code)

Inklay is perfect for displaying custom built dashboards. This guide will explain how you can leverage the Inklay App Server and Claude Code to create your very own dashboard and display it on the Inklay.

You can create your own Weather Dashboard, a personal Solar Manager Dashboards, your own Calendar App and much more. The possibilities are endless.

{% embed url="<https://www.youtube.com/watch?v=igLsXEL1Z3E>" %}

**Examples**

<div><figure><img src="https://2873613899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfDz2dNIYKtA9Qw6PB28G%2Fuploads%2FEV9iIlZO4GtZg5lYPxFf%2F04-stocks.png?alt=media&amp;token=b43fa944-e47e-4ccf-ae11-9c38e26ff658" alt=""><figcaption></figcaption></figure> <figure><img src="https://2873613899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfDz2dNIYKtA9Qw6PB28G%2Fuploads%2Fe6jPk6yGCA3TRg15bxm2%2F05-quote.png?alt=media&amp;token=a8ad894c-1319-4e19-ac6b-bdd762682d08" alt=""><figcaption></figcaption></figure> <figure><img src="https://2873613899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfDz2dNIYKtA9Qw6PB28G%2Fuploads%2FPguKfKVv7fDMCrrdQkEy%2F06-news.png?alt=media&amp;token=b941a6d1-4a96-4f81-bdc8-3ee157295d5a" alt=""><figcaption></figcaption></figure> <figure><img src="https://2873613899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfDz2dNIYKtA9Qw6PB28G%2Fuploads%2FoDWBAnzqIgA9bS2GrmEB%2F03-transit.png?alt=media&amp;token=ec37c71b-a9a3-4668-8c58-9c99ba2c29c7" alt=""><figcaption></figcaption></figure> <figure><img src="https://2873613899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfDz2dNIYKtA9Qw6PB28G%2Fuploads%2FANKFCCh9jmtYwhUQDlR6%2F02-todo.png?alt=media&amp;token=7c341d92-3004-42b4-9902-871305e37679" alt=""><figcaption></figcaption></figure> <figure><img src="https://2873613899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfDz2dNIYKtA9Qw6PB28G%2Fuploads%2FSeOuBNSDKwNAo3ufLHdr%2F01-calendar.png?alt=media&amp;token=feb8811b-fc84-48ff-a3f6-bbf856d26acb" alt=""><figcaption></figcaption></figure></div>

## Setup Guide

{% stepper %}
{% step %}

### Get the Inklay App Server

Download the Inklay App Server from Github (via Code → Download ZIP): <https://github.com/inklayapp/inklay_2_app_server>
{% endstep %}

{% step %}

### Customize your dashboard with Claude

* Open the folder in Claude Code or the Claude desktop app. The folder contains a `CLAUDE.md` file. It tells Claude about the Inklay display (1872 × 1404 pixels, greyscale), the default font and how to rebuild the app, so you don't have to explain it.
* Describe what you want to see, for example:
  * *"Show today's weather for Zurich."*
  * *"Show my next 5 calendar events."*
  * *"Show my solar production from Solar Manager."*
  * *"Make it portrait."*
* Claude builds your dashboard, checks the result and rebuilds the Inklay App Server app. Claude also installs Go once for the rebuild if it’s missing.

{% hint style="info" %}
If your dashboard needs a login or an API key, it is saved only on your computer, in `config.json`.
{% endhint %}
{% endstep %}

{% step %}

### Start the App Server

* Start it:
  1. Mac: double-click dist/InklayAppServer-mac-applesilicon
  2. Windows: double-click dist/InklayAppServer-windows.exe
* A browser page opens. It shows your Image URL and a preview of the dashboard.
* A small window (Terminal on Mac) stays open while the App Builder runs. Keep it open.
  {% endstep %}

{% step %}

### Connect your Inklay

* On the browser page, copy the url: `http://192.168.0.33:8080/dashboard.png`.
* In the Inklay app, add the [Image URL](https://file+.vscode-resource.vscode-cdn.net/Users/vonnielu/Desktop/image-url.md) app to a button. Set the app as active.
* Paste the URL and choose how often your Inklay should wake up.

<div align="left"><figure><img src="https://2873613899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfDz2dNIYKtA9Qw6PB28G%2Fuploads%2FPSA2R8cdFHQMkJ4kh7BP%2Fapp-imageurl-1.png?alt=media&amp;token=72257a8c-d0d4-497a-8f85-095cd7404175" alt="" width="188"><figcaption></figcaption></figure></div>

Your Inklay now loads the dashboard every time it wakes up. The computer must be on, awake, and on the same Wi-Fi as the Inklay.
{% endstep %}

{% step %}

### Stop the App Server

Just close the Terminal Window.
{% endstep %}
{% endstepper %}
