An open API service indexing awesome lists of open source software.

https://github.com/charmingdc/polify

Pollify is your go-to web app for creating and sharing polls with ease. Whether you're collecting opinions, making data-driven decisions, or just having fun, Pollify makes it simple. Engage your audience and gather insights effortlessly! ✨
https://github.com/charmingdc/polify

open-source polling simple

Last synced: 8 months ago
JSON representation

Pollify is your go-to web app for creating and sharing polls with ease. Whether you're collecting opinions, making data-driven decisions, or just having fun, Pollify makes it simple. Engage your audience and gather insights effortlessly! ✨

Awesome Lists containing this project

README

          

# **Pollify: Effortless Poll Creation & Sharing!** 🎉

Pollify makes creating and sharing polls super easy! Collect opinions, make data-driven decisions, and engage your audience effortlessly. 📊✨

## 🚀 Installation

Get Pollify up and running locally with these simple steps:

- ⬇️ **Clone the Repository**:
```bash
git clone git@github.com:Charmingdc/Polify
```

- 📦 **Install Dependencies**:

```bash
npm install
```

- ⚙️ **Configure Firebase**:
- Set up a Firebase project on the [Firebase Console](https://console.firebase.google.com/).
- Enable Authentication and Firestore Database.
- Add your Firebase configuration to your environment variables.


- 🚀 **Run the Application**:

```bash
npm run dev
```

## 💻 Usage

Pollify is designed to be intuitive and user-friendly. Here are some examples to get you started:

Creating a Poll

1. Navigate to the `Create Poll` page.
2. Enter your question, description (optional), and options.
3. Choose whether the poll should be `public` or `private`.
4. Click `Create Poll` to publish your poll!

![Create Poll Screenshot](https://i.imgur.com/your-create-poll-screenshot.png)

Voting on a Poll

1. Go to the poll page using the unique poll URL.
2. Select your choice from the available options.
3. Click on your preferred option to vote.
4. See the results instantly!

![Vote Poll Screenshot](https://i.imgur.com/your-vote-poll-screenshot.png)

## ✨ Features

- ✅ **Effortless Poll Creation:** Create polls with ease using a simple and intuitive interface.
- 🌐 **Public & Private Polls:** Choose whether to make your polls public or keep them private for specific audiences.
- 📊 **Real-Time Results:** View poll results in real-time and make data-driven decisions.
- 📱 **Mobile Responsive:** Access and use Pollify on any device, anywhere.
- 🔗 **Easy Sharing:** Share polls with a unique link for easy access.

## 🛠️ Technologies Used

| Technology | Link |
| :----------------- | :----------------------------------------- |
| React | [https://react.dev/](https://react.dev/) |
| TypeScript | [https://www.typescriptlang.org/](https://www.typescriptlang.org/) |
| Vite | [https://vitejs.dev/](https://vitejs.dev/) |
| Tailwind CSS | [https://tailwindcss.com/](https://tailwindcss.com/) |
| Firebase | [https://firebase.google.com/](https://firebase.google.com/) |
| React Router DOM | [https://reactrouter.com/en/main](https://reactrouter.com/en/main) |
| React Firebase Hooks | [https://github.com/jherr/react-firebase-hooks](https://github.com/jherr/react-firebase-hooks) |

## 🤝 Contributing

We welcome contributions to Pollify! Here are some guidelines:

- 🐛 **Report Issues:** If you find a bug, please open an issue.
- 🛠️ **Submit Pull Requests:** Fork the repository, make your changes, and submit a pull request.
- 💡 **Suggest Features:** Have an idea? Open an issue to discuss it.

## 📜 License

This project is licensed under the [MIT License](LICENSE).

## 🧑‍💻 Author Info

- **Adebayo Muis**
- [GitHub](https://github.com/Charmingdc)
- [LinkedIn](https://www.linkedin.com/in/adebayo-muis)
- [Twitter](https://twitter.com/Charmingdc01)

---

[![Readme was generated by Dokugen](https://img.shields.io/badge/Built%20with-Dokugen-brightgreen)](https://github.com/samueltuoyo15/Dokugen)