Skip to content

Commit

Permalink
Update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
crespire committed Oct 17, 2024
1 parent 89702ff commit 8a75ab2
Show file tree
Hide file tree
Showing 3 changed files with 22 additions and 10 deletions.
6 changes: 3 additions & 3 deletions .github/actions/setup-services/action.yml
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
name: Setup Test Database
description: Set up the test Database
name: Set up db and storage config
description: Set up db and storage configurations.

runs:
using: "composite"
steps:
- name: Setup PSQL
- name: Set up db and storage configuration
shell: bash
run: |
cp config/database.yml.sample config/database.yml
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/tests.yml
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ jobs:
with:
bundler-cache: true

- name: Setup Project
- name: Set up Project
uses: ./.github/actions/setup-services

- name: Precompile Assets
Expand Down
24 changes: 18 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,18 +6,30 @@ Website, Rails powered!
* Ruby 3.2.2
* yarn 1.22.6
* node >= 20
* PSQL >= 14

### Development Setup
Changes should be added via merge request, as `main` has a CI action that deploys on merge.
Changes should be added via merge request, as `main` has a CI action that deploys on merge. The application relies on a PostgreSQL instance for its database, so make sure to set that up for your local environment.

Currently, the application does not require any database and so defaults to SQLite, but this might change in the future.
Because we use ActionText, the application does require dependencies for ActiveStorage as well (ie, `libvips`) though these are currently not used.

The database and storage configurations are provided in a `.sample` file, make sure you copy those and rename them to the correct `.yml` file. These files are git ignored, so you can set up your local environment as needed.

1. Pull/clone the repo
1. `bundle install`
1. `yarn install`
1. Run `bundle install`
1. Run `yarn install`
1. Run `cp ./config/database.yml.sample ./config/database.yml`
1. Run `cp ./config/storage.yml.sample ./config/storage.yml`
1. Edit the two files above as needed.
1. Run `bundle exec rails db:setup`

This should get the application setup and ready to run.

This should get the application setup.
To run the application locally:
1. Run `bin/dev` - this command will watch JS and CSS to rebuild
1. Run `bundle exec rails s` - this command will run the Rails server

To run development, run `bin/dev` - this command will watch JS and CSS to rebuild and run the Rails server
### Deploying to Production
This application is deployed via Dockerfile, so changes that will affect dependencies, etc should be reflected in the `Dockerfile`.


0 comments on commit 8a75ab2

Please sign in to comment.