Comment on page
🛠
Setup Your Environment
Dive into contributing by setting up your local development environment. Follow these steps to clone the Beaver Notes repository and get ready for action.
Please note that specific system-dependent packages might be required, such as rpm for building .rpm packages or different libraries to ensure compatibility. If you encounter any issues while setting up your environment, please open a GitHub issue with the following details:
- Operating system and version
- Architecture of your system
- Description of the issue you are facing
- Output of the command that triggered the issue
Install Git
Before you start contributing to Beaver Notes, ensure you have Git installed on your computer. If you don't have Git installed, you can download and install it from the official website: https://git-scm.com/
Install Node.js and npm
Beaver Notes requires Node.js (v16) and npm (Node Package Manager) to build and run. If you don't have Node.js and npm installed, you can download them from the official Node.js website
Install Yarn
Once you have Node.js and npm installed, you can use npm to install Yarn globally by running the following command in your terminal or command prompt:
npm install -g yarn
To contribute to the Beaver Notes project, you'll need to fork the official repository. Go to the Beaver Notes repository on GitHub and click the "Fork" button in the top right corner. This will create a copy of the repository under your GitHub account.
After forking the repository, you need to clone it to your local machine. Open a terminal or command prompt on your computer and run the following command:
git clone https://github.com/your-username/beaver-notes.git
Replace "your-username" with your GitHub username.
This command will download the repository to your computers.
By default, your cloned repository is connected to your forked version on GitHub. To keep your fork in sync with the official repository and get the latest updates, you'll need to configure an "upstream" remote. In the terminal, navigate to the cloned repository's directory and run:
git remote add upstream https://github.com/daniele-rolli/beaver-notes.git
This sets the official Beaver Notes repository as the upstream remote.
Beaver Notes has certain dependencies required for development. Install them by running the following command in the terminal:
yarn install
This will install all the necessary dependencies specified in the project's package.json file.
You're now all set up to start contributing to Beaver Notes! The next steps involve building and testing the app, contributing code, and enhancing documentation. Join the community and be part of shaping the future of note-taking! 🚀