Skip to content

ShayanFaghihi/finland-events

Repository files navigation

Event Finder App

Event Finder App Screenshot

This is a React + TypeScript application created with Vite that allows you to explore and discover various events and conferences in Finland. The app utilizes GraphQL and Apollo Client to fetch event data. React Router is used for navigation, and custom hooks are implemented for data management.

Features

  • Browse a list of events and conferences in Finland.
  • Search for specific events using a query.
  • Filter events by date using a date picker functionality.
  • View detailed information about each event, including organizers.

Technologies Used

  • React: A JavaScript library for building user interfaces.
  • TypeScript: A statically typed superset of JavaScript for enhanced development.
  • GraphQL: A query language for APIs that provides a more efficient and powerful alternative to REST.
  • Apollo Client: A GraphQL client for React applications that simplifies data fetching and management.
  • React Router: A routing library for React that enables navigation within the app.
  • Custom Hooks: Custom React hooks are used for data management.

Getting Started

To run this project locally, follow these steps:

  1. Clone the repository:

    git clone https://github.com/your-username/event-finder-app.git
  2. Navigate to the project directory:

    cd event-finder-app
  3. Install dependencies using npm or Yarn:

    npm install
    # or
    yarn
  4. Create a .env file in the project root and add your GraphQL endpoint:

    REACT_APP_GRAPHQL_ENDPOINT=https://your-graphql-api.com/graphql
  5. Start the development server:

    npm run dev
    # or
    yarn dev
  6. Open your web browser and visit http://localhost:3000 to view the app.

Live Demo

You can also access a live version of this app deployed on Vercel:

Event Finder App Live Demo

Screenshots

Here is a screenshot of the Event Finder App:

Event Finder App Screenshot


Feel free to explore and customize this React + TypeScript project to suit your needs. Happy coding! 🚀