Description: Socious is a talent marketplace that makes impact work accessible and transparent. We connect purpose-driven professionals with impact organizations through AI matching. We use blockchain to make impact work traceable and reward contributions.
Problem: 94% of young people want to contribute to social causes, but only 10% are able to do so. This is because impact work is not easily accessible or transparent. They don’t see career progression, they are unsure of whether their work creates a real impact, or the salary is low in these impact jobs.
Solution: That’s why we built Socious to provide a new path for these purpose-driven professionals so that they don’t need to choose between their career and their desire to do good, because they can achieve both at the same time on Socious. And we make their impact work transparent and traceable.
- TypeScript: Provides static type checking to enhance code quality and maintainability.
- ESLint: Linting utility for identifying and reporting on patterns in JavaScript/TypeScript.
- Prettier: An opinionated code formatter to ensure consistent code style.
- Jest: Utilized for unit testing to ensure code reliability.
- Cypress: End-to-end testing framework for testing the application in a browser-like environment.
- Material UI (MUI): React components for faster and easier web development.
- Redux Toolkit: Advanced state management, including RTK Query for efficient data fetching. Redux is used for managing the global state of the application.
- React Hook Form: Efficient and flexible library for handling forms in React.
- Vite: Used for build tooling, optimizing the development experience.
- Storybook: UI testing and documentation tool that facilitates the development of isolated React components, allowing for easier testing and review, as well as serving as a living documentation of components.
- React-router: Our router package
All contributions to this project will be released under the GNU General Public License (GPL) v3. By submitting a pull request or filing a bug, issue, or feature request, you are agreeing to comply with this waiver of copyright interest. Details can be found in our LICENSE.
There are two primary ways to help:
- Using the issue tracker, and
- Changing the codebase.
Use the issue tracker to suggest feature requests, report bugs, and ask questions. This is also a great way to connect with the developers of the project as well as others who are interested in this solution.
Use the issue tracker to find ways to contribute. Find a bug or a feature, and mention in the issue that you will take on that effort, then follow the Changing the code-base guidance below.
Generally speaking, you should fork this repository, make changes in your own fork, and then submit a pull request. All new code should have associated unit tests that validate implemented features and the presence or lack of defects. Additionally, the code should follow any stylistic and architectural guidelines the project prescribes. In the absence of such guidelines, mimic the styles and patterns in the existing codebase.
Use the package manager npm to install the app. The app pipeline is created with npm
npm installThe app has two environments production and development and three targets.
Amplify CICD is used for our web deployment. prod branch is connected to our production environment and main branch is connected to our development environment.
git push origin maingit push origin prodPrerequisite: MacOS and XCode
npm run open:iosPrerequisite: Android Studio
npm run open:android