From 807df0de8fd1cff1b6044d0a2e2137209a5c2cf6 Mon Sep 17 00:00:00 2001 From: michelleyeoh Date: Wed, 15 Apr 2026 22:37:10 -0700 Subject: [PATCH 1/5] removed irrelavant info & added info --- README.md | 60 +++++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 43 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index b64134cce..c53d3421e 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,12 @@ -# Some Notes Before You Begin +# HackDavis Hub +HackDavis Hub is a web application that centralizes resources for hackers and judges for HackDavis's annual collegiate hackathon. + +## Some Notes Before You Begin Make sure you follow all of the steps in "Setting Up Your Development Environment" before attempting to even look at the code. Also, read through the docs linked under the "Contributing to the Codebase" section so you can get a feel for the tools and syntax we will be going through. -# Setting Up Your Development Environment - -Before you begin, create a folder for this team wherever you want to store any GitHub repos that you will be cloning on your device in this cohort. You can name it include, platform_team, or literally anything you want to. If you choose to name it "include", **do not use a '#' in your folder name**, it'll cause a bunch of problems later. +# ⚙️ Setting Up Your Development Environment ## 1. NODE.JS @@ -13,7 +14,7 @@ Node.js is a runtime environment that is used to run Javascript code. It comes w 1. Download the Node.js installer for your OS from https://nodejs.org/en/download/current 2. Run the installer and follow the installation wizard. -3. Once the installation finishes, open a terminal on VSCode and type _node --version_ to verify your node installation. Type _npm --v_ to verify your npm installation. +3. Once the installation finishes, open a terminal on VSCode and type ```node --version``` to verify your node installation. Type ```npm --v``` to verify your npm installation. a. If you get an error saying that node or npm is not recognized as a command, try restarting VSCode to see if the issue fixes itself. (If you had VSCode opened while installing Node, this should fix it.) b. If the problem persists, search for _Environment variables_ in your Start menu. Click on _Edit your Environment variables_. Click on _Environment Variables_ in the new window that opens up. @@ -48,11 +49,11 @@ ESLint is an extension that ensures that your code adheres to certain code style ## 4. MongoDB ### 4.1 Installation -To get MongoDB set up locally, you'll need to install MongoDB on your machine along with mongosh (the command line tool for MongoDB). Then, you'll also need MongoDBCompass to view your database with a new interface. **The goal is to have mongosh working, once that works, other parts of the tutorial are optional.** +To get MongoDB set up locally, you'll need to install MongoDB on your machine along with mongosh (the command line tool for MongoDB). Then, you'll also need MongoDB Compass to view your database with a new interface. **The goal is to have mongosh working, once that works, other parts of the tutorial are optional.** - Install MongoDB on Mac: https://www.mongodb.com/docs/manual/tutorial/install-mongodb-on-os-x/ - Install MongoDB on Windows: https://www.mongodb.com/docs/manual/tutorial/install-mongodb-on-windows/ - https://www.mongodb.com/products/tools/compass -- + ### 4.2 Database and User setup Inside MongoDB Compass, connect to the client and create a new database using the plus sign near the Database part of the sidebar menu. For collections, just name it anything since it will be deleted later. @@ -81,17 +82,15 @@ MONGO_DB_HOST=127.0.0.1:27017/ ``` Replace `, , ` with the actual username, password, and database names. (Don't include the angle brackets). -### 4.4 Testing & Initialization -Do this after the getting started portion (right after this section) +# Getting Started -Assuming you have already run `npm install` and `npm run dev` is producing a web page for you to view, you can continue with this part. You will be running the `npm run init` command which will **wipe your database** and initialize it with a `pokemon` and `trainers` collection. In the future, you can edit this initialization in the `_data/collections.json` file. If this works, then your MongoDB Compass (after a refresh) should display that your database has these two collections. This means everything is working! +Install all packages in package.json file: -## Getting Started -Set up: - -`npm install` for package installations. This will install all packages specified in the package.json file. +```bash +npm install +``` -Run the development server: +Run the development server on http://localhost:3000/ ```bash npm run dev @@ -180,5 +179,32 @@ You'll see that there are folders defined with square brackets around the name s - https://restfulapi.net/http-methods/ - https://medium.com/@nadinCodeHat/rest-api-naming-conventions-and-best-practices-1c4e781eb6a5 -**Note** -If your app only has a frontend, feel free to delete the `(api)` folder. +## Contributors +### ⭐ 2026 Team +- Michelle Yeoh +- Sandeep Reehal +- Haylie Tan +- Afifah Hadi +- Alex Marasigan +- Jack Zheng + +### ⭐ 2025 Team +- Jay Jain +- Win Cheng +- Austin Shih +- Brandon Wong +- Daniel Kim +- Haylie Tan +- Michelle Yeoh +- Sandeep Reehal + +### ⭐ 2024 Team +- Trishna Sharma +- Sauvikesh Lal +- Win Cheng +- Brandon Wong +- Austin Shih +- Jay Jain + +# Documentation +Please refer to the HackDavis Notion. \ No newline at end of file From 2899e5eeea892ae86cff25e942bd131b15f715b1 Mon Sep 17 00:00:00 2001 From: michelleyeoh Date: Wed, 15 Apr 2026 22:41:14 -0700 Subject: [PATCH 2/5] added seeding db instr --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index c53d3421e..8eb9f6be6 100644 --- a/README.md +++ b/README.md @@ -82,6 +82,9 @@ MONGO_DB_HOST=127.0.0.1:27017/ ``` Replace `, , ` with the actual username, password, and database names. (Don't include the angle brackets). +### 4.4 Seeding your Database +Please refer to the Hackdavis Notion. + # Getting Started Install all packages in package.json file: From 6d37ee0c7f2b746b1d54bab69c9d34891e7449ae Mon Sep 17 00:00:00 2001 From: michelleyeoh Date: Wed, 15 Apr 2026 22:43:00 -0700 Subject: [PATCH 3/5] add env detail --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 8eb9f6be6..1ceda03e9 100644 --- a/README.md +++ b/README.md @@ -87,6 +87,8 @@ Please refer to the Hackdavis Notion. # Getting Started +Add your local `.env` file (refer to Slack secrets). + Install all packages in package.json file: ```bash From c9902025b02923d54805b2ed96d712b4e95fd3c0 Mon Sep 17 00:00:00 2001 From: michelleyeoh Date: Wed, 15 Apr 2026 23:01:25 -0700 Subject: [PATCH 4/5] migration comment --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index 1ceda03e9..01a2bc99c 100644 --- a/README.md +++ b/README.md @@ -83,6 +83,9 @@ MONGO_DB_HOST=127.0.0.1:27017/ Replace `, , ` with the actual username, password, and database names. (Don't include the angle brackets). ### 4.4 Seeding your Database +Run `npx migrate-mongo up` to apply migrations (updates Validation). + +### 4.5 Seeding your Database Please refer to the Hackdavis Notion. # Getting Started From cdf6b5ba8e0dad505932e4a8167465717d6a88a1 Mon Sep 17 00:00:00 2001 From: michelleyeoh Date: Thu, 16 Apr 2026 09:44:47 -0700 Subject: [PATCH 5/5] fixed titles --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 01a2bc99c..97490526d 100644 --- a/README.md +++ b/README.md @@ -82,13 +82,13 @@ MONGO_DB_HOST=127.0.0.1:27017/ ``` Replace `, , ` with the actual username, password, and database names. (Don't include the angle brackets). -### 4.4 Seeding your Database -Run `npx migrate-mongo up` to apply migrations (updates Validation). +### 4.4 Initialize Database Schema +Run `npx migrate-mongo up` to apply migrations. ### 4.5 Seeding your Database Please refer to the Hackdavis Notion. -# Getting Started +# 🚀 Getting Started Add your local `.env` file (refer to Slack secrets). @@ -110,7 +110,7 @@ Run a linting test: npm run lint ``` -# Contributing to the Codebase +# 🌱 Contributing to the Codebase ## React Resources - https://react.dev/learn/tutorial-tic-tac-toe - https://react.dev/reference/react/useState @@ -214,5 +214,5 @@ You'll see that there are folders defined with square brackets around the name s - Austin Shih - Jay Jain -# Documentation +# 📄 Documentation Please refer to the HackDavis Notion. \ No newline at end of file