Add hands-on tutorial: CIP-30 wallet connect and first preview transaction (Mesh)

Open
#265 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
70/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active
Tech stack
typescript
Domain
documentation

Research direction

Start by comparing the existing local-cardano-payment-detector tutorial with the content under website/docs/tutorials/. Add the new tutorial and update Tutorials navigation or Getting Started with links to Mesh docs, the faucet, and DevEx Getting Started. Done means the guide covers CIP-30 connection, a Mesh preview transaction, signing, submission, explorer confirmation, and troubleshooting, and npm run build succeeds.

Written by the indexing model from the issue text.

Description

documentation enhancement good first issue Medium Priority stale

Problem

The Tutorials section currently has essentially one real hands-on guide (local-cardano-payment-detector). Newcomers who want a browser + wallet dApp path still hit a thin tutorials area (#115). The old Tools stub page was removed (#191), so we also need a clear “start building a dApp” entry that points at widely used tooling such as Mesh.

Proposed solution

Add a second tutorial that walks through:

  1. Connect a CIP-30 browser wallet
  2. Build a simple payment transaction with Mesh (or equivalent maintained TS SDK)
  3. Sign and submit on preview testnet
  4. Confirm on an explorer
  5. Short troubleshooting (network mismatch, missing collateral, API keys)

Include links to Mesh docs, faucet, and DevEx Getting Started.

Acceptance criteria

  • New tutorial page under website/docs/tutorials/
  • Listed in Tutorials navigation / Getting Started
  • Uses preview testnet (no mainnet funds required)
  • Clear prerequisites and copy-pasteable steps
  • npm run build succeeds

Related

  • #115
  • #191 (tools stub removed; this helps replace that entry path)
Dominant language
TypeScript
Stars
13
Forks
22
Avg merge
18h 40m
Merged PRs (30d)
11

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from IntersectMBO/developer-experience

All issues in IntersectMBO/developer-experience

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.