adds documentation
This commit is contained in:
parent
5d9cf51c10
commit
bc82be4344
47
ASDFVM_SETUP.md
Normal file
47
ASDFVM_SETUP.md
Normal file
@ -0,0 +1,47 @@
|
||||
# ASDFVM Setup
|
||||
1. Run
|
||||
```bash
|
||||
$ git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.8.1
|
||||
```
|
||||
|
||||
2. Run
|
||||
```bash
|
||||
$ code ~/.bashrc
|
||||
```
|
||||
This assumes you have VS Code installed on your computer (if you don't then install it by searching for it online and installing it).
|
||||
|
||||
3. Add the following lines at the end of the file and save it.
|
||||
```bash
|
||||
. $HOME/.asdf/asdf.sh
|
||||
. $HOME/.asdf/completions/asdf.bash
|
||||
```
|
||||
4. If you are on Mac make sure you have homebrew installed.
|
||||
`/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`
|
||||
5. Close your terminal and reopen it.
|
||||
|
||||
## Installing the NodeJS plugin
|
||||
1. Install the plugin
|
||||
```bash
|
||||
$ asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git
|
||||
```
|
||||
|
||||
## Installing the Postgres plugin
|
||||
1. Install the dependencies
|
||||
|
||||
Mac
|
||||
```bash
|
||||
$ brew install gcc readline zlib curl ossp-uuid
|
||||
```
|
||||
|
||||
Ubuntu
|
||||
```
|
||||
$ sudo apt-get install linux-headers-$(uname -r) build-essential libssl-dev libreadline-dev zlib1g-dev libcurl4-openssl-dev uuid-dev
|
||||
```
|
||||
|
||||
2. Install the plugin
|
||||
```
|
||||
$ asdf plugin-add postgres
|
||||
```
|
||||
|
||||
|
||||
Restart your terminal when it is done.
|
16
README.md
16
README.md
@ -29,10 +29,20 @@ To retrieve changes from the starter app run
|
||||
$ git pull upstream main
|
||||
```
|
||||
## Prerequisites
|
||||
### VSCode
|
||||
I know there are bunch of editors but trust me, VS Code will make your life easier, mostly becuase it is what I use and if you have issues I can help you. If you use something else IT WILL BE YOUR RESPONSIBILITY TO MAKE SURE IT IS CONFIGURED PROPERLY.
|
||||
|
||||
Look [here](/VSCODE.md) for information about which extensions and settings we will use.
|
||||
|
||||
### WSL
|
||||
If you are on Windows you will need to install WSL2 you must be on windows 10 or higher.
|
||||
You can find the instructions on how to set this up [here.](/WSL_SETUP.md)
|
||||
|
||||
### asdf-vm
|
||||
Tool versions are managed using `asdf-vm`. You will need to have `asdf-vm` installed first.
|
||||
Tool versions are managed using `asdf-vm`. You will need to have `asdf-vm` installed first. You can install it by following the instructions [here.](/ASDFVM_SETUP.md)
|
||||
|
||||
## Setup
|
||||
Make sure your have navigated to the project directory in your terminal.
|
||||
### Tool versions
|
||||
Install the tool versions by running
|
||||
```bash
|
||||
@ -190,7 +200,3 @@ We finally made it! To deploy your app to Heroku run
|
||||
$ git push heroku main
|
||||
```
|
||||
and thats it!
|
||||
|
||||
|
||||
|
||||
|
||||
|
9
VSCODE.md
Normal file
9
VSCODE.md
Normal file
@ -0,0 +1,9 @@
|
||||
# VS Code
|
||||
## Extensions
|
||||
These are the extensions you should install into VS Code
|
||||
|
||||
- ESLint (Microsoft)
|
||||
- Tailwind CSS Intellisense (Tailwind Labs)
|
||||
|
||||
## Settings
|
||||
Press `Ctrl+,` or `Cmd+,` to open your settings and make sure the box for `Editor: Insert Spaces` is checked and set `Editor: Tab Size` to 2.
|
14
WSL_SETUP.md
Normal file
14
WSL_SETUP.md
Normal file
@ -0,0 +1,14 @@
|
||||
# Setup WSL
|
||||
1. Open the `Turn Windows features on or off` page in the Control Panel
|
||||
2. Enable `Window Subsystem for Linux` and `Virtual Machine Platform`
|
||||
3. Restart your computer
|
||||
4. Install windows terminal from the Microsoft app store.
|
||||
5. Open Windows Terminal
|
||||
6. Run the command `wsl --set-default-version 2`
|
||||
7. Run the command `wsl --install -d Ubuntu`
|
||||
8. Fill out the information when the new window opens.
|
||||
9. In your ubuntu terminal create an ssh-key by running `ssh-keygen`. I would just leave everything as the default including the password empty for this key.
|
||||
10. Get your public key by running `cat ~/.ssh/id_rsa.pub` in your ubuntu terminal.
|
||||
11. Add that key to github.
|
||||
12. In the Windows Terminal app setting set the default profile to be Ubuntu (you may need to close windows terminal and reopen it for Ubuntu to show up.)
|
||||
|
Loading…
Reference in New Issue
Block a user