Skip to content

zanetasochon/Give-things-back

Repository files navigation

Welcome to the Give Things Back Project👋

The aim of the project is to create a website where everyone can donate unnecessary items to trusted institutions. The website will have a simple form that will make it easier for users to donate items.

Motivation

Users have items at home that they want to get rid of, but don't know how. There are many solutions available, but many of them require additional effort or there is no trust in them. Verified places require a trip, which people may not have time for or may not be able to go to. Local containers or collections are unverified, and it is unclear whether the items will actually go to those in need.

Project

Link to the app: Give Things Back

Project Author

This project was created by Żaneta Sochoń.

Tools / techniques

  • Supabase
  • Vite
  • TypeScript
  • React with Hooks
  • Redux Toolkit
  • React with Hooks
  • ESlint
  • Material-UI library
  • React Router DOM
  • CSS3 (SCSS/SASS)

Getting Started

Prerequisites

To run the project locally, you will need the following installed on your machine:

  • Node.js
  • NPM package manager

Installation

  1. Clone the repository to your local machine,

  2. Open a terminal and navigate to the project folder,

  3. Install the required dependencies by running npm install.

Running the project

  1. Open a terminal in the project folder Run:
npm run dev 

to start the project

  1. Open a web browser and navigate to http://localhost:3000 to view the site

Building the project

To build the project for production, run:

npm run build

The production-ready files will be placed in the dist folder.

🤝 Contributing

Contributions to the project are welcome! Please feel free to submit a pull request if you would like to make any improvements or additions.

About

An app that allows you to donate things to those in need

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors