Skip to content

Latest commit

 

History

History
124 lines (82 loc) · 2.36 KB

MAC_SETUP.md

File metadata and controls

124 lines (82 loc) · 2.36 KB

Install Needed Dependencies

Homebrew

If you haven't already, install the homebrew package manager.

Postgres

Use homebrew to install and run postgresql:

brew install postgresql
brew services start postgresql

If you have an older version of postgres, brew postgresql-upgrade-database

For a more GUI focused postgres experience, try Postgres.app an alternative to the CLI focused default postgres

If you are having trouble connecting to your local postgres database using pgAdmin or another local tool, try the following configuration: Host Name: localhost Port: 5432 Maintenance Database: postgres Username: you_mac_login_username (Can be found by calling whoami in a terminal) Password: password

Ruby

Rbenv

It is often useful to install Ruby with a ruby version manager. The version of Ruby that comes with Mac is not sufficient for this project. You can install rbenv with:

brew install rbenv ruby-build

Then, setup rbenv:

rbenv init

And finally, follow the setup instructions that are outputted to your terminal after running that.

Actually installing Ruby

Next, install the version of Ruby that this project uses. This can be found by checking the file in this repo, .ruby-version.

To install the appropriate ruby version, run:

rbenv install 3.2.4

(Do not forget to switch 3.2.4 to the appropriate version)

Finally, run:

rbenv local 3.2.4

(Do not forget to swtich 3.2.4 to the appropriate version)

Nodejs

The Casa package frontend leverages several javascript packages managed through yarn, so if you are working on those elements you will want to have node, npm, and yarn installed.

brew install node
brew install yarn

Chrome

Many of the frontend tests are run using Google Chrome, so if you don't already have that installed you may wish to include it:

brew install google-chrome

Project setup

Install gem dependencies with:

bundle install

Setup the database with:

bin/rails db:setup

Install javascript dependencies with:

yarn install

Compile assets with:

yarn build

and then:

yarn build:css

And lastly, run the app with:

bin/rails server

See the README for login information.