Skip to content

Source for the official website of the Associated Students of Pomona College

License

Notifications You must be signed in to change notification settings

aspc/aspc-website

Repository files navigation

CircleCI Coverage Status

ASPC Website 2.0

This repo is intended to be a complete rewrite of pomonastudents.org (formerly aspc.pomona.edu). The aim of this project is to:

  • Put the content that most people use front and center
  • Redesign the website from the ground up
  • Streamline and trim legacy features

Development

This repo is run and maintained by the ASPC Software Development Group, but anyone may contribute to this repository! If you attend Pomona College or any of the other Claremont Colleges and would like to join, please feel free to reach out to us at software@aspc.pomona.edu.

Getting Up And Running

It's simple to start contributing! We've also provided a more detailed Getting Started Guide with information about setting up this project to work with an IDE, our core technologies, and more helpful tips.

  1. Clone this repo
  2. Install Docker
  3. Run docker-compose build from inside the cloned directory
  4. Run docker-compose up -d
  5. Initalize the database with the following commands:
docker-compose run web bundle exec rails db:create
docker-compose run web bundle exec rails db:migrate
  1. Navigate to localhost:3000 to see a local copy of this website up and running!

Contributing

For guidelines of how to contribute to this project, head to CONTRIBUTING.md

Troubleshooting

Step 3 - Yarn/Node fail (on ARM Apple Silicon)

When running docker-compose build on an M1/M2 mac, if apt-key output should not be parsed or gpg: no valid OpenPGP data found is received:

In Dockerfile

  • Comment out lines 10 - 12
  • Comment out lines 15 - 16
  • Change line 26 to imagemagick chromium

Step 5 - NoMethodError

If NoMethodError: undefined method '[]' for nil:NilClass is received when running docker-compose run web bundle exec rails db:create, change line 89 in config/database.yml to

password: <%= Rails.application.credentials[:database_credentials_production] %>

localhost not working

Check if aspc-rails and aspc-postgres are running on Docker. If aspc-rails has exited, review logs. Possible solution (if specified in logs) is to delete /tmp/pids/server.pid

License

This project is licensed under the MIT standard license, which may be read at LICENSE.md.

I have a feature request / There's a problem with the website!

If you're familiar with GitHub, open up a GitHub Issue and we'll take a look at it, or, better yet, feel free to implement the changes yourself and submit a pull request! If the issue is urgent, contact us at product@aspc.pomona.edu.