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
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.
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.
- Clone this repo
- Install Docker
- Run
docker-compose buildfrom inside the cloned directory - Run
docker-compose up -d - 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
- Navigate to localhost:3000 to see a local copy of this website up and running!
For guidelines of how to contribute to this project, head to CONTRIBUTING.md
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
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] %>
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
This project is licensed under the MIT standard license, which may be read at LICENSE.md.
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.