Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Add step-by-step instructions to README.md

Open
#11 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
1-3 hours
Newbie friendliness
40/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Stale
Domain
documentation

Research direction

Start by opening README.md and reviewing the existing guidance for the private-data-transfer-cli and private-data-transfer-ui samples. Use the listed Node.js version checks, npm install steps, npm run start commands, and UI port 3000 details to organize a step-by-step setup flow; done means a non-Node.js developer can launch both samples and understand what each demonstrates.

Written by the indexing model from the issue text.

Description

documentation good first issue

I was working on the getting started docs in FireFly, and I wanted to defer all the samples related docs to point at the README. md in this repo.

However, unless you're a Node.js developer I don't think currently there's quite enough info in this repo to get people started.

Here's what was in the docs on the FireFly side, which I'm pulling out.
I think even this is a little bit less than the step by step someone might need.

... raising a separate issue for a discussion on getting a Docker built samples gallery


This repository contains two straightforward, turnkey samples. A simple CLI-based flow, and a more robust flow with a React frontend, with the option for customized recipients and messaging strings.

  • FireFly Samples Repo
    • clone this ^^
  • Node.js - latest version recommended (v14.17.0)
    • node -v to check your current version
  • Install the node dependencies in each folder: (/firefly-samples/private-data-transfer-cli & /firefly-samples/private-data-transfer-ui) with npm install.
  • The following command: npm run start will kick either program. Run the command separately from the root of each project.
    • The "Private-Data-Transfer-Cli" will self execute with a message broadcast and acknowledgement of message receipt.
    • The "Private-Data-Transfer-UI" will serve locally on port 3000. You can toggle amongst your FireFly memberships to see different message/transaction details - timestamp, sender and inputs.
Dominant language
TypeScript
Stars
25
Forks
24
PR merge metrics
No merged PRs in 30d

Getting set up

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 hyperledger-firefly/samples

All issues in hyperledger-firefly/samples

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.