From 8c2ba35ece02d4481e369ead1e5d5ad2a2b69795 Mon Sep 17 00:00:00 2001 From: David M <62346025+aboutdavid@users.noreply.github.com> Date: Thu, 14 Mar 2024 16:17:36 -0400 Subject: [PATCH 1/2] Update instructions to be more beginner friendly --- README.md | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index ab977fd..4cd44a9 100644 --- a/README.md +++ b/README.md @@ -19,8 +19,10 @@ Built by Obl.ong, a membership-first nonprofit -- we encourage contributions! - Install Ruby **3.3.0** - Install Ruby on Rails with Bundler -- Install Bun for compiling tailwind -- Pull submodules +- Install [Bun](https://bun.sh) for compiling tailwind (`curl -fsSL https://bun.sh/install | bash`) +- Pull submodules (`git submoudle init && git submodule update`) +- Compile tailwind (`bun run build:css`) +- Generate active record encryption keys (`bin/rails db:encryption:init`) - Run `rails credentials:edit` and add these keys: ``` @@ -30,9 +32,13 @@ Built by Obl.ong, a membership-first nonprofit -- we encourage contributions! postmark_api_token: "POSTMARK_API_TOKEN" sentry: SENTRY_URI + active_record_encryption: + primary_key: PRIMARY_KEY + deterministic_key: DETERMINISTIC_KEY + key_derivation_salt: KEY_DERIVATION_SALT ``` - -- Run `rails assets:precompile` (if building for prod - DO NOT DO IN DEVELOPMENT) + Note: Sentry isn't required. +- If you are building for production, run `rails assets:precompile`. Don't do this in development. - Copy `app/javascript/application.js` to `public/assets/application-{hash}.js` (must be done every time assets is recompiled) - Edit `config/application.rb` to reflect your environment - Start the server with `bin/rails server` @@ -46,4 +52,3 @@ We are working to integrate with [Weblate](https://hosted.weblate.org/projects/o ![Domains index showing 3 domains](https://github.com/obl-ong/admin/assets/19589006/227d0a2e-70a2-4227-befc-7d3ce6fdc1bb) ![DNS page for fionaho.obl.ong showing 2 records, an A record to 1.1.1.1, and a CNAME at demo to example.com](https://github.com/obl-ong/admin/assets/19589006/b3cd0329-9380-4758-b5e6-22afc7601333) - From 40d06ceacab39289687664fd2663ca29c1eeae39 Mon Sep 17 00:00:00 2001 From: aboutdavid <62346025+aboutdavid@users.noreply.github.com> Date: Thu, 14 Mar 2024 23:18:33 -0400 Subject: [PATCH 2/2] Include disabling sentry & compiling tailwind. --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 4cd44a9..6eef8ad 100644 --- a/README.md +++ b/README.md @@ -21,7 +21,7 @@ Built by Obl.ong, a membership-first nonprofit -- we encourage contributions! - Install Ruby on Rails with Bundler - Install [Bun](https://bun.sh) for compiling tailwind (`curl -fsSL https://bun.sh/install | bash`) - Pull submodules (`git submoudle init && git submodule update`) -- Compile tailwind (`bun run build:css`) +- Compile tailwind (`rails css:build`) - Generate active record encryption keys (`bin/rails db:encryption:init`) - Run `rails credentials:edit` and add these keys: @@ -40,7 +40,7 @@ Built by Obl.ong, a membership-first nonprofit -- we encourage contributions! Note: Sentry isn't required. - If you are building for production, run `rails assets:precompile`. Don't do this in development. - Copy `app/javascript/application.js` to `public/assets/application-{hash}.js` (must be done every time assets is recompiled) -- Edit `config/application.rb` to reflect your environment +- Edit `config/application.rb` to reflect your environment. If you didn't provide a Sentry URI, please set `config.sentry` to false. - Start the server with `bin/rails server` ## Translations