Skip to content

Commit 8ce901c

Browse files
authored
Merge pull request #109 from danbaruka/devex-sessions-clean
Session 03 doc : 03-dev-environment-setup
2 parents d45c9a0 + 49c28cb commit 8ce901c

4 files changed

Lines changed: 75 additions & 7 deletions

File tree

website/docs/working-group/q1-2025/sessions/03-environment-setup/readme.md renamed to website/docs/working-group/q1-2025/sessions/03-dev-environment-setup/01-session/readme.md

Lines changed: 19 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
1+
---
2+
title: Session 03 Overview
3+
sidebar_label: Session
4+
slug: /working-group/q1-2025/sessions/03-dev-environment-setup/session
5+
---
6+
17
# Cardano Dev Environment
28

3-
A well-structured environment is essential for building, testing, and contributing to Cardano projects. This guide outlines the core components and links you to canonical setup instructions. For background on core repos and ecosystem resources, see the Kickoff session: [Core Repositories](../01-kickoff-orientation/readme.md#core-repositories) and [Documentation Resources](../01-kickoff-orientation/readme.md#documentation-resources).
9+
A well-structured environment is essential for building, testing, and contributing to Cardano projects. This guide outlines the core components and links you to canonical setup instructions. For background on core repos and ecosystem resources, see the Kickoff session: [Core Repositories](../../01-kickoff-orientation/readme.md#core-repositories) and [Documentation Resources](../../01-kickoff-orientation/readme.md#documentation-resources).
410

511
## Version Control
612

@@ -11,7 +17,7 @@ Use Git and GitHub for collaboration and traceability.
1117
- Git installed locally (`git --version`)
1218
- Suggested branch model: `main` (stable), `dev` (active), `feature/*` (scoped work)
1319

14-
Refer to governance, repos, and contribution links in [Documentation Resources](../01-kickoff-orientation/readme.md#documentation-resources) instead of duplicating here.
20+
Refer to governance, repos, and contribution links in [Documentation Resources](../../01-kickoff-orientation/readme.md#documentation-resources) instead of duplicating here.
1521

1622
## Development Tools
1723

@@ -25,7 +31,7 @@ Recommended setup for editing, shell, and formatting:
2531
- [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) or [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint)
2632
- **Optional (protocol work/Haskell toolchain)**: [ghcup](https://www.haskell.org/ghcup/) to manage GHC, Cabal, HLS
2733

28-
For broader tooling and SDKs, see [Essential Tooling](../01-kickoff-orientation/readme.md#essential-tooling).
34+
For broader tooling and SDKs, see [Essential Tooling](../../01-kickoff-orientation/readme.md#essential-tooling).
2935

3036
## Wallets
3137

@@ -38,7 +44,7 @@ You use wallets to hold keys, sign transactions, and interact with dApps.
3844
- When you use extension wallets, you have an easy way to connect dApps in the browser. It helps you test user flows quickly with a familiar UI.
3945
- Use for dApp development, frontend integration, and user testing on testnets.
4046

41-
See options and integration links in [Kickoff › Wallet Integration](../01-kickoff-orientation/readme.md#wallet-integration).
47+
See options and integration links in [Kickoff › Wallet Integration](../../01-kickoff-orientation/readme.md#wallet-integration).
4248

4349
## Cardano CLI and Node
4450

@@ -74,7 +80,7 @@ Prefer an API if you don’t need to run a full node.
7480

7581
For service options and links, see:
7682

77-
- [Kickoff Orientation › Block Explorers & APIs](/docs/working-group/q1-2025/sessions/kickoff-orientation#block-explorers--apis)
83+
- [Kickoff Orientation › Block Explorers & APIs](../../01-kickoff-orientation/readme.md#block-explorers--apis)
7884

7985
API keys and endpoints vary by network (mainnet, preprod, preview).
8086

@@ -107,5 +113,11 @@ API keys and endpoints vary by network (mainnet, preprod, preview).
107113
- Maintain separate configs for `mainnet`, `preprod`, and `preview`
108114
- Align node/CLI versions with official releases
109115
- Document project-specific steps in your repo `README` for team consistency
110-
- For deeper ecosystem links (wallets, SDKs, explorers), see [Essential Tooling](../01-kickoff-orientation/readme.md#essential-tooling) and [Block Explorers & APIs](../01-kickoff-orientation/readme.md#block-explorers-apis)
111-
This document is part of the Q1 2025 Developer Experience Working Group sessions.
116+
- For deeper ecosystem links (wallets, SDKs, explorers), see [Essential Tooling](../../01-kickoff-orientation/readme.md#essential-tooling) and [Block Explorers & APIs](../../01-kickoff-orientation/readme.md#block-explorers-apis)
117+
118+
## Session Resources
119+
120+
- Explore companion materials in the [Cardano Dev Environment resources](../02-resources/readme.md), including the Cardano Demo Wallet Dashboard repository.
121+
122+
This document is part of the Q1 2025 Developer Experience Working Group sessions.
123+
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# Resources
2+
3+
Hands-on project to explore a dashboard implementation for Cardano wallet activity. Use this repository when working through the **Cardano Dev Environment** session to practice connecting tooling and inspecting transactions end-to-end.
4+
5+
### 🧭 Repository
6+
[![GitHub – danbaruka/cardano-demo-wallet-dashbord](https://img.shields.io/badge/GitHub-cardano--demo--wallet--dashbord-181717?logo=github&style=for-the-badge)](https://github.com/danbaruka/cardano-demo-wallet-dashbord)
7+
- Focus: Wallet interactions, transaction monitoring, UI integration
8+
- Suggested usage:
9+
- Clone the repo and install dependencies as documented
10+
- Review environment variables and configuration flows
11+
- Experiment with connecting to preview or preprod networks while following the session exercises
12+
13+
<a href="https://github.com/danbaruka/cardano-demo-wallet-dashbord" target="_blank" rel="noopener noreferrer">
14+
<img src="https://github-readme-stats.vercel.app/api/pin/?username=danbaruka&repo=cardano-demo-wallet-dashbord&theme=default&hide_border=false" alt="GitHub repository card for danbaruka/cardano-demo-wallet-dashbord" />
15+
</a>
16+
17+
---
18+
19+
*Referenced by the Q1 2025 Developer Experience Working Group session “Cardano Dev Environment”.*
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
title: Session 03 Recording
3+
sidebar_label: Recording
4+
slug: /working-group/q1-2025/sessions/03-dev-environment-setup/recording
5+
---
6+
7+
# Session Recording
8+
9+
🎥 **Cardano Dev Environment Walkthrough**
10+
11+
<iframe
12+
src="https://drive.google.com/file/d/1z2drEvAVl1ON7FRvJLPwg16nzje5CffV/preview"
13+
title="Session 03: Dev environment setup walkthrough"
14+
width="100%"
15+
height="480"
16+
allow="autoplay"
17+
allowfullscreen
18+
style={{border: 0, borderRadius: '12px', boxShadow: '0 16px 40px rgba(1, 40, 170, 0.18)'}}
19+
/>
20+
21+
- **Status**: Recording available above.
22+
- **Highlights**:
23+
- Local environment prerequisites
24+
- Wallet tooling demo (CLI + dashboard)
25+
- Node configuration walkthrough
26+
- Q&A and troubleshooting tips
27+
28+
For additional sessions, check the [Working Group Session Recordings](../../../media/session-recordings/readme.md) hub.
29+
30+
---
31+
32+
*This recording belongs to the Q1 2025 Developer Experience Working Group: “Laying the Foundations”.*
33+
Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
{
2+
"label": "Session 03: Dev environment setup",
3+
"position": 3
4+
}

0 commit comments

Comments
 (0)