MadiMalik / wwcode-hackathon2023

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Lavender

Women Who Code Hackathon for Social Good 2023

Challenge Statement & Proposed Solution:

Addressing the challenge of students' mental health struggles due to resource limitations, the solution bridges the gap between family and professional support, reduces stigma, and offers diverse communities curated resources and direct professional access. Utilizing a tech stack of emerging technologies such as JS, EJS, HTML, Bootstrap (front-end) and Python, Flask, MySQL (back-end), the non-profit website provides free access to a broad audience.

screenshot-home

Functionality

Our application provides adolescents with a secure environment to foster their mental health and overall well-being. When a user is signed in, they gain the capability to express their emotions, drawing inspiration from the Zones of Proximal Development. From there, they can select a corresponding activity to address their current emotional state. Following the activity, users have the opportunity to reflect on their experience, tracking their emotions and insights to assess the effectiveness of the chosen activity. Additionally, they can initiate a conversation with a trusted adult, whether it's a school counselor, teacher, or a parent, for further support and guidance. Both users who are logged in or haven't signed up yet get access to activities based on goals and resources.

How It's Made:

Tech used: HTML, CSS, Bootstrap, JavaScript, EJS, Express, MongoDB, Mongoose, Git, Github

We decided to make our app with these application since they were technologies most of us were familiar with. We felt like they would be quick to start with and develop with to get the main structure of our application started for this challenge.

Optimizations

While the main structure of our application is complete, there are many things we would have liked to add. We didn't have the chance to incorporate a backend, however if we had we would have been able to develop way more functionality, like allowing users to sign in and save the data about their interactions in the database. It also would have made it easier to develop the front end because we could have iterated over the data and wouldn't have had to repeat so much in our ejs files.

Some things we would have loved to add if we had more time were activites that coincided with the goals a user chose or the emotion they chose to work on. Also, we would have loved to add a calender feature that kept track of a users reflections after they completed an activity. While we were able to finish the UI for the soundbar, we would have also loved to incorporate a music API to actually be able to play music.

Lessons Learned:

  • We needed better communication so we could have a plan b in case things went wrong or someone wasn’t able to complete part of our project.
  • We tried to create a typical git/github workflow, however for some participants who were new to git, maybe having them merge main into their branches was too much too soon.
  • We should have met as a group more often so we understood our roles better.

Steps to collaborate or view this project:

Clone the Repo:

  • From the terminal, cd into where you want to save the repo.
  • Clone the repo:
    • git clone git@github.com:samanthatarrice/wwcode-hackathon2023.gitOR
    • https://github.com/samanthatarrice/wwcode-hackathon2023.gitif you don't have your SSH key set up.
  • Make sure you are in the cloned repo directory:
    • cd wwcode-hackathon2023

Installations:

  • Run npm install
  • Install Node (or upgrade to version 18) if you don't have it already.
  • Install Nodemon:
    • This is optional, but highly recommended because you won't need to constantly restart your server when you change anything.
    • npm install -g nodemon
  • Install MongoDB:
    • Either follow along with Leon's instructions or this video.

Start Server:

  • nodemon app.jsOR
  • node app.jsif you didn't install nodemon

Create a branch, commit changes and create pull requests (PR):

  • git checkout -b <your-branch-name-here>
  • git add .
  • git commit -m "Your commit message here"
  • git push origin <your-branch-name-here>
    • You will see a link in your terminal to go to the PR on Github.
    • Add reviewers, assign yourself, and any relevant notes.
    • Create your PR!

About


Languages

Language:EJS 79.7%Language:CSS 14.8%Language:JavaScript 5.4%