Shaanu | Sharing is caring, one item at a time

Shaanu is a mobile app that empowers neighbors to share unused food, household items with each other or even money, helping to alleviate the financial burden of everyday life. By connecting those with resources (who have enough to spare) to those in need, Shaanu aims to reduce household and food waste, while also fostering a spirit of community and cooperation. Whether it's a bag of rice, a jar of peanut butter, or a set of kitchen utensils, Shaanu provides a platform for neighbors to come together and support one another during these challenging times.

Google playstore link (Currently on beta test): HERE

Features

• 💎 User profiles: Users can create profiles showcasing their available items, including photos and descriptions.
• 💎 Search function: Users can search for specific items by category, location, or keyword.
• 💎 Pickup: Users can directly through the app arrange pickup of items.
• 💎 Donation feature: Users can choose to donate items they no longer need to charity or goodwill organizations.
• 💎 Virtual inventory management: Users can keep track of their available items and request notifications when someone expresses interest in an item they have listed.
• 💎 Social media integration: Users can share their experiences and discoveries on social media platforms like Facebook, Twitter, and Instagram.
• 💎 Push notifications: Users receive timely updates on donated items.
• 💎 Gamification elements (Todo): To encourage engagement and participation, the app could incorporate gamified features such as point systems, badges, or leaderboards.
• 💎 Item tracking: Users can mark items as "gone" or "available again" to help maintain accurate inventories and avoid double booking.

Built with

• ⚡️ Expo
• ⚛️ React Native
• ✨ TypeScript
• ✨ Firebase
• 🃏 Jest — Configured for unit testing
• 🤖 Conventional Commit Lint — Make sure you & your teammates follow conventional commit

Getting Started

1. Clone the repo:

git clone https://github.com/todak2000/shaanu.git

2. Install dependencies

It is encouraged to use yarn so the husky hooks can work properly.

cd shaanu
yarn install

3. Run the development server

You can start the server using this command:

npx expo start

Open on expoGo, physical Andorid/iOS device as you prefer

4. Refer to the Backend API documentation

app/db/README.md - HERE