Pet Owners and Animal Lovers Social Network - Frontend

🐾 Project Overview

This is a full-stack social networking web application designed for pet owners and animal lovers. The project was developed as a graduation project in the 4th year of university, focusing on creating a community platform for pet enthusiasts.

🚀 Technologies Used

• Frontend:
  • React.js (v18.2.0)
  • React Router (v6.22.3)
  • Redux Toolkit (v2.2.3)
  • Material-UI (v5.15.15)
• State Management: Redux
• Routing: React Router
• HTTP Client: Axios
• Real-time Communication: Socket.IO Client
• Styling: Tailwind CSS
• Authentication: JWT

✨ Features

• User registration and authentication
• Profile creation and management
• Pet profile creation
• Social networking capabilities
• Real-time messaging
• Post creation and interaction
• Responsive design

🔧 Prerequisites

• Node.js (v14+ recommended)
• npm (v6+)

📦 Installation

1. Clone the repository

git clone https://github.com/alper-demir/pet-owners-and-animal-lovers-social-network-client.git

2. Install dependencies

npm install

3. Create a .env file with the following variables:

• REACT_APP_API_BASE_URL: Backend API base URL
• REACT_APP_SOCKET_URL: WebSocket server URL

🖥️ Running the Application

Development Mode

npm start

Runs the app in development mode. Open http://localhost:3000 to view it in your browser.

Production Build

npm run build

Builds the app for production in the build folder.

📂 Project Structure

• src/
  • components/: Reusable React components
  • pages/: Page-level components
  • stores/: Redux store and slices
  • router.js: Application routing configuration
  • App.js: Main application component

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

This project is open-source.

👨‍💻 Author

Alper Demir - GitHub Profile