https://github.com/danieljancar/hangbuddies
An open-source, monorepo-based web application that enables users to quickly create and share surveys without registration or any other fuss.
https://github.com/danieljancar/hangbuddies
monorepo open-source quick-poll survey-app
Last synced: 4 months ago
JSON representation
An open-source, monorepo-based web application that enables users to quickly create and share surveys without registration or any other fuss.
- Host: GitHub
- URL: https://github.com/danieljancar/hangbuddies
- Owner: danieljancar
- License: mit
- Created: 2025-02-21T09:57:06.000Z (over 1 year ago)
- Default Branch: develop
- Last Pushed: 2025-06-12T13:46:57.000Z (about 1 year ago)
- Last Synced: 2025-06-12T19:04:16.934Z (about 1 year ago)
- Topics: monorepo, open-source, quick-poll, survey-app
- Language: TypeScript
- Homepage:
- Size: 1.96 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
HangBuddies
A fast, shareable, registration-free tool for gathering preferences and picking dates with customizable options.
[](https://www.figma.com/design/26m3Y13QluW8Zk6z5qhvRa/HangBuddies?node-id=0-1&t=esKJwF80FX0P2PkB-1)
[](https://github.com/danieljancar/hangbuddies/actions/workflows/frontend.yml)
[](https://github.com/danieljancar/hangbuddies/actions/workflows/backend.yml)
[](https://github.com/danieljancar/hangbuddies/actions/workflows/prettier.yml)
[](https://github.com/danieljancar/hangbuddies/actions/workflows/label-pr.yml)
[](https://github.com/danieljancar/hangbuddies/actions/workflows/github-code-scanning/codeql)
[](https://github.com/danieljancar/hangbuddies/actions/workflows/dependabot/dependabot-updates)
[](https://github.com/danieljancar/hangbuddies/issues)
[](#license)
# Table of Contents
- [Features](#features)
- [Contributing](#contributing)
- [Prerequisites](#prerequisites)
- [Dependencies](#dependencies)
- [Tools](#tools)
- [Installation](#installation)
- [Configuration](#configuration)
- [Live Previews](#live-previews)
- [Staging (Pre-Production)](#staging-pre-production)
- [Development (Pre-Staging/active development)](#development-pre-stagingactive-development)
- [License](#license)
- [Acknowledgements](#acknowledgements)
- [Contributors](#contributors)
# Features
- **Event Polls**: Create and share event polls effortlessly.
- **No Registration**: Creators and participants can vote without an account.
- **Customizable Options**: Define time slots, add descriptions, and set preferences.
- **Responsive UI**: Works across devices for easy access.
# Contributing
> [!Important]
> This project is still in initial development, and we are working on setting up configuration for contributors.
Contributions are welcome! Please read the [contribution guidelines](CONTRIBUTING.md) and other
relevant [documents](docs/) for developers before getting started.
## Prerequisites
### Dependencies
We use multiple tools to build HangBuddies. The following are the minimum requirements to get started:
- **Node.js**: Version `^20` or higher
- **npm**: Version `^10` or higher
- **pnpm**
- **yarn**
- **Angular CLI**: For building and running the frontend
- **NestJS CLI**: For building and running the backend
### Tools
- **Bruno**: Free and open-source API client (find useful collections in `bruno/`)
- **Docker**: For running the backend locally
- **NVM**: For managing Node.js versions (https://github.com/nvm-sh/nvm)
## Installation
Collaborators can clone this original repository, as a contributor you should make a fork onto your account.
```shell
git clone https://github.com/danieljancar/hangbuddies.git
cd hangbuddies
# Node > 20
npm run install:all # Install all dependencies in the project (submodules)
```
> [!Important]
> Make sure you run `npm run install:all` (Node > 20) at root before doing any work, so all tools and hooks are working.
## Configuration
> [!Note]
> As already mentioned, we are working on setting up configuration for contributors. Please check back later.
## Live Previews
We have multiple live previews of different environments. You can find them in the following links:
### Staging (Pre-Production)
- **Frontend**: [https://stage.hangbuddies.com](https://stage.hangbuddies.com)
- **Backend**: [https://api-stage.hangbuddies.com](https://api-stage.hangbuddies.com)
### Development (Pre-Staging/active development)
- **Frontend**: [https://dev.hangbuddies.com](https://dev.hangbuddies.com)
- **Backend**: [https://api-dev.hangbuddies.com](https://api-dev.hangbuddies.com)
> [!Note]
> The environments above are hosting the latest `staging` and `develop` branches. The `staging` branch is the latest
> pre-stable version of the application, while the `develop` branch is the latest development version. They are seeded
> with test data and are not meant for production use.
# License
This project is licensed under [MIT License](LICENSE). By contributing to HangBuddies, you agree that your contributions
will be licensed under the same license. Also, you agree to
the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md) and the [Developer Certificate of Origin](DCO.md).
# Acknowledgements
## Contributors
Thanks to the following people for their contributions:
[](https://github.com/danieljancar/hangbuddies/graphs/contributors)
Released under the [MIT License](LICENSE) by [@danieljancar](https://github.com/danieljancar).