Heart of Passion is a nonprofit organization led by dedicated teen volunteers. The group organizes specialized retreats for adolescents with cancer, aiming to foster emotional support and meaningful connections among attendees. Created by teens for teens, these retreats serve as a unique platform for young cancer patients to share experiences and create lasting memories, all within a nurturing environment.

This repository aims to support teen volunteers in their retreat planning and budgeting efforts.

Development Setup

• Get a locally running MongoDB instance
  • If you have docker installed I believe docker run --name mongodb -d -p 27017:27017 mongo will work
• Create a .env file in the root of the repository with the content: DATABASE_URL=YOUR-URL-HERE
  • This is generally DATABASE_URL=mongodb://localhost:27017/heartofpassion
• npm install
• npm run generate-dummy-data
• npm run dev
• TODO Authentication setup

Run With Docker

1. Install Docker
2. Start the application with Docker Compose: docker compose up

If you make any changes to the packages, you may need to rebuild the images. To do this, append --build to the above docker compose up command.

The Dockerized application will have live-reloading of changes made on the host machine.

Note: On linux-based operating systems, if you come across an entrypoint permission error (i.e. process: exec: "./entrypoint.sh": permission denied: unknown), run chmod +x ./entrypoint.sh to make the shell file an executable.

Windows Users: If you come across this error exec ./entrypoint.sh: no such file or directory when running the docker compose command, please follow this Stackoverflow thread to fix it.

Major Technologies

• MongoDB
• Next.js
• Tailwind CSS
• tRPC
• Chakra UI
• Mongoose