Skip to content

docs: adds nix to readme#791

Open
raul-oliveira wants to merge 3 commits intomasterfrom
raul-oliveira/update-readme-with-nix
Open

docs: adds nix to readme#791
raul-oliveira wants to merge 3 commits intomasterfrom
raul-oliveira/update-readme-with-nix

Conversation

@raul-oliveira
Copy link
Copy Markdown
Contributor

@raul-oliveira raul-oliveira commented Jul 15, 2025

Acceptance Criteria

  • Update the readme with nix

Security Checklist

  • Make sure you do not include new dependencies in the project unless strictly necessary and do not include dev-dependencies as production ones. More dependencies increase the possibility of one of them being hijacked and affecting us.

Summary by CodeRabbit

  • Documentation
    • Significantly expanded setup and prerequisites section with comprehensive step-by-step guidance for configuring Nix development environments
    • Added Node.js v22 installation instructions
    • Included detailed dependency installation guidance for both npm and yarn

@raul-oliveira raul-oliveira self-assigned this Jul 15, 2025
@raul-oliveira raul-oliveira moved this from Todo to In Progress (Done) in Hathor Network Jul 15, 2025
@raul-oliveira raul-oliveira removed the request for review from andreabadesso March 13, 2026 16:55
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Mar 13, 2026

📝 Walkthrough

Walkthrough

This change expands the README.md with detailed setup instructions covering Nix with flakes configuration, repository initialization, Node.js v22 installation, and dependency management via yarn/npm, totaling 23 new lines of documentation.

Changes

Cohort / File(s) Summary
Documentation Setup
README.md
Added comprehensive prerequisites and step-by-step setup instructions for Nix-based development environment configuration, Node.js installation, and dependency management.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A README grows with wisdom new,
Setup paths now crystal clear and true,
Nix and Node in harmony aligned,
Dev environments perfectly designed,
Hop along, the docs now light the way! 🌟

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs: adds nix to readme' directly and accurately describes the main change—adding Nix setup documentation to the README file.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch raul-oliveira/update-readme-with-nix
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (2)
README.md (2)

49-60: Clarify dependency-install flow (Yarn vs npm) and fix typo.

Line 49 has a typo (depencies), and the section currently mixes yarn and npm install as parallel instructions without guidance. Please state one preferred path (or explicitly separate alternatives) to avoid setup confusion.

Suggested edit
-then, install the depencies: 
+Then, install the dependencies:
 ```sh
 yarn

+Alternatively, if you prefer npm:
+sh +npm install +
...
-### To install dependencies

- -npm install -
+### To install dependencies (npm alternative)
+sh +npm install +

</details>

<details>
<summary>🤖 Prompt for AI Agents</summary>

Verify each finding against the current code and only fix it if needed.

In @README.md around lines 49 - 60, Fix the typo "depencies" to "dependencies"
and clarify the install flow by choosing a preferred path or clearly separating
alternatives: in the "To install dependencies" section (and the earlier line
showing yarn) either state a single preferred command (e.g., "Preferred: yarn"
with the yarn command) or explicitly label both options as alternatives (e.g.,
"Install dependencies (yarn - preferred)" with the yarn command, and a separate
subsection "Install dependencies (npm alternative)" with the npm install
command), ensuring only one place tells users to run yarn and a distinct,
labeled place shows npm to avoid confusion.


</details>

---

`33-33`: **Fix wording, spelling, and link text on the Nix intro line.**

Line 33 has a typo (`enviroment`) and non-descriptive link text (`link`). Please make the sentence clearer and use descriptive anchor text.


<details>
<summary>Suggested edit</summary>

```diff
-For a better developer experience we suggest nix usage for managing the enviroment. Visit this [link](https://nixos.org/download/#download-nix) to download it.
+For a better developer experience, we suggest using Nix to manage the environment. Visit the [official Nix download page](https://nixos.org/download/#download-nix).
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 33, Fix the typo and make the Nix intro sentence clearer:
change "enviroment" to "environment", rewrite the sentence to read more
naturally (e.g., "For a better developer experience, we recommend using Nix to
manage the development environment.") and replace the non-descriptive anchor
text "link" with descriptive text like "Nix download page" (keep the same URL
https://nixos.org/download/#download-nix).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Around line 43-47: Remove the shell prompt characters from the code blocks so
the commands are raw: replace lines that start with "$ git clone
https://github.com/HathorNetwork/hathor-wallet.git" and "$ nix develop" with the
same commands but without the leading "$" (i.e., "git clone
https://github.com/HathorNetwork/hathor-wallet.git" and "nix develop") inside
the existing fenced code blocks to satisfy MD014.
- Around line 37-39: The fenced code block containing "experimental-features =
nix-command flakes" lacks a language identifier; update the Markdown fenced
block that surrounds that line (the triple-backtick block) to include a language
tag (e.g., use ```conf) so the block becomes a highlighted "conf" code fence to
satisfy the linter and improve readability.

---

Nitpick comments:
In `@README.md`:
- Around line 49-60: Fix the typo "depencies" to "dependencies" and clarify the
install flow by choosing a preferred path or clearly separating alternatives: in
the "To install dependencies" section (and the earlier line showing yarn) either
state a single preferred command (e.g., "Preferred: yarn" with the yarn command)
or explicitly label both options as alternatives (e.g., "Install dependencies
(yarn - preferred)" with the yarn command, and a separate subsection "Install
dependencies (npm alternative)" with the npm install command), ensuring only one
place tells users to run yarn and a distinct, labeled place shows npm to avoid
confusion.
- Line 33: Fix the typo and make the Nix intro sentence clearer: change
"enviroment" to "environment", rewrite the sentence to read more naturally
(e.g., "For a better developer experience, we recommend using Nix to manage the
development environment.") and replace the non-descriptive anchor text "link"
with descriptive text like "Nix download page" (keep the same URL
https://nixos.org/download/#download-nix).

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: dc113859-59c3-492d-a3f7-0758a688cbc6

📥 Commits

Reviewing files that changed from the base of the PR and between 4cc9a34 and e13f354.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md
Comment on lines +37 to +39
```
experimental-features = nix-command flakes
```
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Add language identifier to fenced code block.

Line 37 starts a fenced block without a language, which triggers markdown linting and reduces readability.

Suggested edit
-```
+```conf
 experimental-features = nix-command flakes
</details>

<!-- suggestion_start -->

<details>
<summary>📝 Committable suggestion</summary>

> ‼️ **IMPORTANT**
> Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

```suggestion

🧰 Tools
🪛 markdownlint-cli2 (0.21.0)

[warning] 37-37: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 37 - 39, The fenced code block containing
"experimental-features = nix-command flakes" lacks a language identifier; update
the Markdown fenced block that surrounds that line (the triple-backtick block)
to include a language tag (e.g., use ```conf) so the block becomes a highlighted
"conf" code fence to satisfy the linter and improve readability.

Comment thread README.md
Comment on lines +43 to +47
$ git clone https://github.com/HathorNetwork/hathor-wallet.git
```
To initialize nix dev environment:
```sh
$ nix develop
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Remove shell prompts from command blocks.

Line 43 and Line 47 include $ prompts without command output. Keeping only raw commands is cleaner and resolves MD014.

Suggested edit
-$ git clone https://github.com/HathorNetwork/hathor-wallet.git
+git clone https://github.com/HathorNetwork/hathor-wallet.git
...
-$ nix develop
+nix develop
🧰 Tools
🪛 markdownlint-cli2 (0.21.0)

[warning] 43-43: Dollar signs used before commands without showing output

(MD014, commands-show-output)


[warning] 47-47: Dollar signs used before commands without showing output

(MD014, commands-show-output)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 43 - 47, Remove the shell prompt characters from the
code blocks so the commands are raw: replace lines that start with "$ git clone
https://github.com/HathorNetwork/hathor-wallet.git" and "$ nix develop" with the
same commands but without the leading "$" (i.e., "git clone
https://github.com/HathorNetwork/hathor-wallet.git" and "nix develop") inside
the existing fenced code blocks to satisfy MD014.

@raul-oliveira raul-oliveira moved this from In Progress (Done) to Todo in Hathor Network Apr 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

1 participant