Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add readme for windows development #92

Merged
merged 1 commit into from
Dec 10, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,10 @@
# Contributing
Contributions are welcome! Please see https://github.com/Developer-DAO/web3-ui/issues for tasks to pick up.

If you developing on Windows see [this](/CONTRIBUTING_ON_WINDOWS.md) page for help on getting your environment setup

## Local development

To setup your local dev environment:
```sh
# Install `yarn`, alternatives at https://yarnpkg.com/en/docs/install
Expand Down
35 changes: 35 additions & 0 deletions CONTRIBUTING_ON_WINDOWS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# Contributing on Windows

If you are developing on a Windows machine, you may need to make modifications to your setup to avoid some issues.

## Install WSL2

Installing and running a Linux distribution on Windows allows you to setup your project within a Linux environment and avoid some issues that come up using Windows.

### Helpful Resources
Here are some helpful resources to install and setup WSL2 on Windows
* Step by step tutorial for installing WSL2 on Windows
* Written Version - https://www.ceos3c.com/wsl-2/install-wsl2-with-windows-terminal/
* YouTube Version - https://www.youtube.com/watch?v=VMZH9Pj2dXw
* The same author has a helpful tutorial on terminal customization that might be helpful
* https://www.youtube.com/watch?v=qiLJhG0O51M

## Setup your working directory

It can be a bit confusing to setup your working directory. You want to be sure that you are storing your project files (and working with them) in your WSL2 file system and not in your Windows file system.

You can quickly see what Linux distributions you have installed by opening up your file explorer and typing the following in the address bar: `wsl\\$`

Select a distribution and navigate into that directory. Continue navigating to `home/[yourUserName]/`. You can create a 'projects' directory here and begin storing your projects in here.

Below are some helpful resources.
* Windows Subsystem for Linux Documentation - https://docs.microsoft.com/en-us/windows/wsl/
* File Storage - https://docs.microsoft.com/en-us/windows/wsl/setup/environment#file-storage
* Setting up VS Code - https://docs.microsoft.com/en-us/windows/wsl/tutorials/wsl-vscode

## Setup your web3-ui project

* Follow the the instructions found in the [CONTRIBUTING](/CONTRIBUTING.md) readme.
* If you run into 'EACCESS' permissions issues:
* double check your directory permissions with `ls -la`
* If the owner is root, you may have problems when running `yarn install`. You can modify the permissions with the following command `sudo chown -R [yourUsername] [yourProjectDir]`. The `-R` is to recurse into each of the files and directories.
11 changes: 6 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,11 +17,12 @@ A library of UI components specifically crafted for web3 use cases.
## Technologies

This project is built with the following open source libraries, frameworks and languages.
| Tech | Description |
| --------------------------------------------- | ----------------------------------------- |
| [React](https://reactjs.org/) | Front end user interface |
| [ChakraUI](https://chakra-ui.com/) | A simple & modular component library |
| [TypeScript](https://www.typescriptlang.org/) | Static type-checking programming language |
| Tech | Description |
| --------------------------------------------- | ------------------------------------------------------------------ |
| [React](https://reactjs.org/) | Front end user interface |
| [ChakraUI](https://chakra-ui.com/) | A simple & modular component library |
| [TypeScript](https://www.typescriptlang.org/) | Static type-checking programming language |
| [Storybook](https://storybook.js.org/) | Open source tool for building UI components and pages in isolation |

## How to Contribute

Expand Down