If you haven't already, install the homebrew package manager.
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
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.
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)
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
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
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.