We promote competitive programming among students through resources, outreach, classes, and contests.

Thanks to Vercel for providing free hosting & continuous deployment!

Instructions (for volunteer hours -- not necessarily needed for other stuff)

1. If not done already, clone the repository cpinitiative/cpinitiative and open up the folder.

2. At the root directory, add a file .env, which will contain the environment configuration for the volunteer-hours. An example .env file will look like

   GOOGLE_CLIENT_ID="....apps.googleusercontent.com"
   GOOGLE_CLIENT_SECRET="asdkjflasdjfklas"
   NEXTAUTH_URL="http://localhost:3000"
   SHEETS_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----..."
   SHEETS_PRIVATE_KEY_ID="1298301asfa98sf09ac0291023"
   FIREBASE_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----..."
   ENCRYPTION_KEY="asdjkflajsdflkjas;ldjfa"
   MJ_APIKEY_PUBLIC="mailjet api key public"
   MJ_APIKEY_PRIVATE=""
   PAYPAL_API_SECRET="ddd"
   MAILGUN_API_KEY=""

   Here's how to get the following keys:

   • Google Sheets: https://developers.google.com/sheets/api/guides/authorizing#APIKey
   • NEXT_AUTH_URL: choose the address of deployment
   • FIREBASE_PRIVATE_KEY -- I don't think this is even needed??
   • ENCRYPTION_KEY -- ask Nathan (or modify cryptography file), used to decrypt firebase key on vercel
   • MJ_APIKEY_PUBLIC/PRIVATE -- ask Nathan, only needed for newsletter
   • MAILCHIMP_API_KEY -- ask Nathan, only needed for class registration system
   • PAYPAL_API_SECRET -- ask Nathan, only needed for class registration system

3. Using the correct configuration file, go into SHEETS_API_CREDS inconfig.ts and make sure the credential object matches your Google Sheet configuration that you retrieved in the previous step.

4. Acquire firebase credentials (or setup emulator), and make sure to replace the configuration in the firebaseAdmin.initializeApp in firebase.ts with the correct configuration.

5. To navigate to the volunteer hours page after running yarn dev, you can go to localhost:3000/view-hours. Then, it should be able to test.

6. Make sure to add access to the sheet in mind through Google Sheets itself (add the service account email as an editor in the sheet)

Here is a sample entry in the table, for reference, which can be called with the google-spreadsheet node package, :