{"id":18841585,"url":"https://github.com/subvisual/heritage-fund","last_synced_at":"2026-01-30T12:30:14.578Z","repository":{"id":149234645,"uuid":"327008534","full_name":"subvisual/heritage-fund","owner":"subvisual","description":"Get a grant for Heritage - Apply for a grant digital frontend","archived":false,"fork":false,"pushed_at":"2021-01-12T13:41:05.000Z","size":2040,"stargazers_count":0,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-30T10:44:14.986Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://funding.heritagefund.org.uk","language":"Ruby","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"heritagefund/funding-frontend","license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/subvisual.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-05T13:33:44.000Z","updated_at":"2021-01-11T16:33:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"4c2b1807-9aa6-49b4-83f7-dbc7cf7a1c45","html_url":"https://github.com/subvisual/heritage-fund","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subvisual%2Fheritage-fund","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subvisual%2Fheritage-fund/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subvisual%2Fheritage-fund/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subvisual%2Fheritage-fund/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/subvisual","download_url":"https://codeload.github.com/subvisual/heritage-fund/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239780122,"owners_count":19695734,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-08T02:51:49.501Z","updated_at":"2025-02-20T04:42:19.948Z","avatar_url":"https://github.com/subvisual.png","language":"Ruby","readme":"# funding-frontend\n\n## Running locally on macOS\n\n### Install Homebrew\n\nCheck to see if [Homebrew](https://brew.sh) is installed by running `which brew` in a terminal. If already \ninstalled you'll get output similar to `/usr/local/bin/brew`, otherwise the command will return `brew not found`.\n\nIf Homebrew is already installed, update it by running `brew update`. \n\nIf Homebrew is not already installed, run \n`/usr/bin/ruby -e \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)\"` to install it.\n\n### Install rbenv\n\nRun `brew install rbenv` to install the latest version of [rbenv](https://github.com/rbenv/rbenv).\n\nRun `rbenv init`, which will run some commands to allow `rbenv` to work with `zsh`, like updating the path.\n\nAdd `eval \"$(rbenv init -)\"` to your `~/.zshrc` profile.\n\n### Install PostgreSQL\n\nRun `brew install postgres` to install the latest version of [PostgreSQL](https://www.postgresql.org).\n\n### Install the recommended version of Ruby\n\nWe specify a recommended version of Ruby in the [`.ruby-version`](.ruby-version) file in funding-frontend. \nTo install this recommended version of Ruby, use rbenv by running `rbenv install x.y.z` inside the application \ndirectory (where `x.y.z` is replaced with the version number specified in [`.ruby-version`](.ruby-version)).\n\n\nYou may need to run `rbenv global x.y.z` to switch your terminal to use the new version.\n\n### Install the PostgreSQL app\n\nDownload and install [Postgres.app](https://postgresapp.com).\n\nRun the Postgres app.\n\n### Configure the necessary environment variables\n\nCreate an empty `.env` file in your application directory by running `touch .env` in a terminal.\n\nThe necessary environment variables in order to run the application are stored in the team's shared\n1Password vault. If you don't have access to the shared 1Password vault, contact @stuartmccoll or @ptrelease.\n\nWith access to the vault, copy the contents of `funding-frontend.env` into your own `.env` file.\n\n### Install the PostgreSQL Gem\n\nInstall the PostgreSQL Gem, telling it the path of PostgreSQL. If PostgreSQL is installed in a default \nlocation, the command will look like:\n\n```bash\ngem install pg -- --with-pg-config=/Applications/Postgres.app/Contents/Versions/latest/bin/pg_config\n```\n\n### Install Bundler\n\nRun `gem install bundler` to install [Bundler](https://bundler.io).\n\n### Install Yarn\n\nRun `brew install yarn` to install [Yarn]((https://yarnpkg.com/lang/en/docs/install/#mac-stable)).\n\n### Install necessary application dependencies\n\nRun `bundle install` to install the Ruby dependencies necessary for the application to run. These are \nspecified in the application's `Gemfile`.\n\nRun `yarn install` to install the Yarn dependencies necessary for the application to run. These are\nspecified in the application's `package.json` and `yarn.lock` files.\n\n### Initialise the database\n\nRun `bundle exec rails db:setup` in your terminal.  If the database needs creating, run\n`psql` then `create database funding_frontend_development;`.\n\n### Running the funding-frontend application\n\nRun `bundle exec rails server` (or `bundle exec rails s` for a shorter command) in your terminal. \nThe application will now be running locally and can be accessed by navigating to \n`https://localhost:3000` in your browser.\n\n---\n\n## Running the automated test suite\n\n### RSpec\n\nServer-side code is tested using [RSpec](https://rspec.info).\n\nTo run the RSpec test suite, run `bundle exec rspec` in your terminal.\n\n### Jest\n\nClient-side code is tested using [Jest](https://jestjs.io).\n\nTo run the Jest test suite, run `yarn jest` in your terminal.\n\n---\n\n## Caching\n\nAddresses are cached after searching by postcode so that they can be referred to later in the user journey. \nBy default, Ruby-on-Rails in development mode runs with caching disabled. In order to see caching work in \ndevelopment, run `bundle exec rails dev:cache` in your terminal.\n\n---\n\n## Toggling feature flags\n\nSome elements of functionality are sat behind feature flags, which have been implemented using \n[Flipper](https://github.com/jnunemaker/flipper).\n\nTo toggle functionality, a Flipper needs to exist. Flipper rows exist within the `flipper_features` and \n`flipper_gates` tables on the database. The `flipper_gates` are populated with a database migration. \nThe `flipper_features` are populated at app runtime, provided rows exist in `flipper.rb`.\n\nUpdate a `flipper_gates` row by running a SQL statement such as (after running \n`psql funding_frontend_development` in your terminal to connect to the database):\n\n```postgresql\nUPDATE flipper_gates SET value = true WHERE feature_key = '\u003ckey_name\u003e';   \n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubvisual%2Fheritage-fund","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsubvisual%2Fheritage-fund","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubvisual%2Fheritage-fund/lists"}