Table of Contents
- [About](#about) - [Built With](#built-with) - [Getting Started](#getting-started) - [Prerequisites](#prerequisites) - [Usage](#usage) - [Frontend Installation](#cookiecutter-template) - [Manual setup](#manual-setup) - [Variables reference](#variables-reference) - [Roadmap](#roadmap) - [Contributing](#contributing) - [Support](#support) - [License](#license) - [Acknowledgements](#acknowledgements)About
Hive.Et is a non-for-profit organization that works to connect volunteers across all walks of life to activities and organizations that are in need of the skills possessed by the individuals in the community. Our Hivers are students, teachers, politicians, company owners, professors, accountants, ... across all walks of lives that make use of their much needed skills to good use by building their community.
We work for fundraising, campaigns, teaching-learning, cleaning, leasing, and much more. The services we provide is not just matching you with what you want and what is nearby and convenient, but also track all your activities to certify and acknowledge your work. We also work **with organization** to serve the custom needs of their organization to meet their **CSR goals**. CSR also known as corporate social responsibility, pertains to people and organizations behaving and conducting business ethically and with sensitivity towards social, cultural, economic, and environmental issues. Striving for social responsibility helps individuals, organizations, and governments have a positive impact on development, business, and society.
Last but not least, we work with schools and education institutions to take charge of volunteers and their activities in a well-controlled manner. Students put to use their in school skills in practice and gain valuable experience by building on what they have learned in class rooms.
Key features of **Hive.Et**:
- Get matched to an organization that needs your skill
- As a volunteer, you can track your progress and achievements
- Print and share your progress with your friends
- Organization can track and track-back your progress
- Checkout organizations near you on a map
- Start a campaign as a registered NGO or a registered company
- Raise funds for different causes
- Unsupervised machine learning to find insight about volunteers, skills-set, demographics...
- Stream live attendees via apache kafka onto geo-maps
Additional infoThis project is built based on Microsoft's Design System Guide and well known component library from microsoft known as Fluent UI - based on Microsoft's Design System This project is the result of huge research. I'm a long-time GitHub user so I've seen more than [7.3k](https://github.com/GedionT?tab=stars) READMEs so far. I've started writing docs for my open source projects (that are currently in their early stages so they exist in the private space for now). After I've **analyzed many popular GitHub** READMEs and other GitHub-related docs and features I've tried to create a general-propose template that may be useful for any project. |
Built With
- React
- Nodejs
- Jest
- FluentUI
- Storybook
- GitHub
- GitHub Actions
- Netlify
- Postman
- Docker
- Google Analytics
- Google Maps
- MapBox GL
- MongoDB
- kSql
- Python
- PM2
- Tensorflow
- Tensorflow-Serve
- Apache Kafka
Getting Started
Prerequisites
The recommended method to get started contributing to Hive.Et is by using cloning the latest commit/ version from Hive. You can also download the repository and then install the dependencies by extracting the directory
The easiest way to start contributing to Hive.et after cloning is
git clone https://github.com/gediont/hive.git
cd hive
npm install hive
Usage
hive frontend
After installing hive, all you need to do is to run the following command:
npm start
Features and Diagrams
- Steps one
- Step two
- Step three
- Step four
or
another set of steps to follow or add descriptions accordingly here
Version reference
Same table description | Name | Default value | Description | | ————————– | —————— | ————————————————————————— | | PROJECT_NAME | My Amazing Project | Your project name | | REPO_SLUG | my-amazing-project | Repo slug must match the GitHub repo URL slug part | | GITHUB_USERNAME | GedionT | Your GitHub username without @ | | FULL_NAME | Alexey Potapov | Your full name | | OPEN_SOURCE_LICENSE | MIT license | Full OSS license name | | modern_header | y | Use HTML to prettify your header | | table_in_about | n | Use table to wrap around About section | | include_logo | y | Include Logo section. Only valid when
modern_header == y
|
Roadmap
See the open issues for a list of proposed features (and known issues).
- Top Feature Requests (Add your votes using the 👍 reaction)
- Top Bugs (Add your votes using the 👍 reaction)
- Newest Bugs
Contributing
First off, thanks for taking the time to contribute! Contributions are what makes the open-source community such an amazing place to learn, inspire, and create. Any contributions you make will benefit everybody else and are greatly appreciated.
Please try to create bug reports that are:
- Reproducible. Include steps to reproduce the problem.
- Specific. Include as much detail as possible: which version, what environment, etc.
- Unique. Do not duplicate existing opened issues.
- Scoped to a Single Bug. One bug per report.
Please adhere to this project’s code of conduct.
Support
Reach out to the maintainer at one of the following places:
- GitHub discussions
- The email which is located in GitHub profile
License
This project is licensed under the MIT license. Feel free to edit and distribute this template as you like.
See LICENSE for more information.
Acknowledgements
Thanks for these awesome resources that were used during the development of the Hive.Et: