Skip to content
Skills Library
Programming · Learning & explanation

compact-core:basic-start

/compact-core:basic-start

This skill should be used when the user asks to "build my first Midnight DApp", "getting started from scratch", "verify my environment", "basic DApp tutorial", "test my Midnight setup", "hello world walkthrough", "new to Midnight", "first contract", "walk me through building a contract", or wants a step-by-step guide to creating and deploying a simple Compact smart contract on a local devnet.

Licence
Apache-2.0
Last repository change
23.10.2026

Assessment and security

90/ 100Class: good
Format15 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
10
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 23.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: examples/ticket-witnesses.ts

What it does and when to use it

This skill should be used when the user asks to "build my first Midnight DApp", "getting started from scratch", "verify my environment", "basic DApp tutorial", "test my Midnight setup", "hello world walkthrough", "new to Midnight", "first contract", "walk me through building a contract", or wants a step-by-step guide to creating and deploying a simple Compact smart contract on a local devnet.

Triggers from the description

build my first Midnight DAppgetting started from scratchverify my environmentbasic DApp tutorialtest my Midnight setuphello world walkthroughnew to Midnightfirst contract
Original author description

This skill should be used when the user asks to "build my first Midnight DApp", "getting started from scratch", "verify my environment", "basic DApp tutorial", "test my Midnight setup", "hello world walkthrough", "new to Midnight", "first contract", "walk me through building a contract", or wants a step-by-step guide to creating and deploying a simple Compact smart contract on a local devnet.

How it works

  1. Prerequisites
  2. Working Directory
  3. Steps
  4. When something errors
  5. When You're Done
Original SKILL.md headings · 68 lines, 391 words
SKILL.md preview
---
name: compact-core:basic-start
description: This skill should be used when the user asks to "build my first Midnight DApp", "getting started from scratch", "verify my environment", "basic DApp tutorial", "test my Midnight setup", "hello world walkthrough", "new to Midnight", "first contract", "walk me through building a contract", or wants a step-by-step guide to creating and deploying a simple Compact smart contract on a local devnet.
version: 0.1.0
---

> **EPHEMERAL — Everything produced by this skill is disposable.** This walkthrough generates code solely to verify your environment works and to build familiarity with Midnight development. Do not commit, push, or retain any generated code. Delete the working directory when done.

# Basic Start: Your First Midnight DApp

A step-by-step procedural guide that takes you from zero to a working Midnight DApp on a local devnet. Each step builds on the previous one, verifying your environment works correctly along the way.

## Prerequisites

Before starting, ensure:
- **Docker** is running (`docker info` should succeed)
- **Node.js 22+** is installed (`node --version`)
- **Compact CLI** is installed (`compact --version`) — if not, use `/midnight-tooling:install-cli`

Run `/midnight-tooling:doctor` to check all prerequisites at once.

## Working Directory

Create a temporary directory for this walkthrough. All generated files go here.

```bash
mkdir -p /tmp/midnight-basic-start && cd /tmp/midnight-basic-start
```

## Steps

Work through each step in order. Each step's reference file contains the full procedure.

| Step | Title | What It Verifies | Reference |
|------|-------|-----------------|-----------|
| 1 | Devnet Setup | Docker, node, indexer, proof server all running | `references/step-1-devnet-setup.md` |
| 2 | Compact CLI | Compiler and CLI installed and up to date | `references/step-2-compact-cli.md` |
| 3 | Wallet Setup | Wallet creation, NIGHT airdrop, DUST registration | `references/step-3-wallet-setup.md` |
| 4 | Hello World Contract | Write, compile, deploy, and call a smart contract | `references/step-4-hello-world-contract.md` |
| 5 | Token Transfer | Programmatic NIGHT transfer between wallets | `references/step-5-token-transfer.md` |
| 6 | Ticket Contract | Privacy-preserving contract with commitments and nullifiers | `references/step-6-ticket-contract.md` |

## When something errors

**Your first stop for any error code or message is `/midnight-status-codes:lookup`.**
It decodes node rejections (e.g. `1010: Custom error: 117`), SDK/Effect errors,
Compact compiler diagnostics, proof-server and indexer errors, and more — telling
you what produced the error and how to fix it.

```
/midnight-status-codes:lookup 117      # a numeric node/ledger code
/midnight-status-codes:lookup NotNormalized   # an error name
```

Common early ones on a fresh devnet: **117** (NotNormalized — set a small
`additionalFeeOverhead`, see step 4/5) and **1010** (the Substrate envelope that
wraps the real `Custom(N)` cause). For environment problems, run
`/midnight-tooling:doctor`.

## When You're Done

Delete the temporary working directory:

```bash
rm -rf /tmp/midnight-basic-start
```

Stop the devnet if you no longer need it:

```
/midnight-tooling:devnet stop --remove-volumes
```
Files in this package (10)
  • SKILL.md 3 KB
  • examples/hello-world.compact 1 KB
  • examples/ticket-witnesses.ts 2 KB
  • examples/ticket.compact 3 KB
  • references/step-1-devnet-setup.md 3 KB
  • references/step-2-compact-cli.md 1 KB
  • references/step-3-wallet-setup.md 13 KB
  • references/step-4-hello-world-contract.md 23 KB
  • references/step-5-token-transfer.md 11 KB
  • references/step-6-ticket-contract.md 18 KB

Versions

The database has no other skills named compact-core:basic-start.

Database snapshot: 13.11.2026 · package version a65a37306fa3 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90compact-core:compact-init-project
    This skill should be used when the user asks to create a new Midnight project, scaffold a Compact smart contract project, initialize a DApp, set up a new Midnight application, start a new project, use a project template, or set up a Midnight development environment for the first…
  • 90midnight-cq:dapp-testing
    This skill should be used when the user asks to test my dapp, write e2e tests, test wallet connection, playwright midnight, test transaction UI, integration test frontend, end-to-end test, browser test, test UI with contract, write Playwright tests for a Midnight dapp, mock…
  • 90prompt-rewriter:generate-midnight-network-dapp-spec
    Use this skill to generate a Midnight Network DApp spec brief through an adaptive Q&A. The output is a concise brief (not a full spec) intended as input to a downstream spec / planning skill such as /superpowers:brainstorming or /sdd:specify. Triggers on "generate midnight dapp…
  • 100cursor-hello-world
    Create your first project with Cursor AI features. Triggers on "cursor hello world", "first cursor project", "cursor getting started", "try cursor ai", "cursor basics". Use when working with cursor hello world functionality. Trigger with phrases like "cursor hello world", "cursor world", "cursor".
  • 100juicebox-hello-world
    Create a minimal working Juicebox example. Use when getting started with Juicebox, creating your first search, or testing basic people search functionality. Trigger with phrases like "juicebox hello world", "first juicebox search", "simple juicebox example", "test juicebox".
  • 90walkthrough
    Turn a multi-step ask into guided execution instead of a command dump: self-execute every step you can, hand the owner only the steps that genuinely need them — one command at a time, each result verified before the next. Use when the owner invokes /walkthrough or asks to be…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.