Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/ggturan/pet-care-client

authentication authorization cloudinary hook-form hook-form-zod jwt nextjs14 nextui quill-editor reactjs social-media tanstack-react-query typescript vercel

Last synced: about 13 hours ago
JSON representation

Pawprints & Tales is a frontend web application designed to provide pet lovers and owners with an engaging and informative platform for accessing pet care tips and heartwarming stories.

Host: GitHub
URL: https://github.com/ggturan/pet-care-client
Owner: GGTuran
Created: 2024-09-28T16:02:46.000Z (3 months ago)
Default Branch: main
Last Pushed: 2024-10-17T17:41:27.000Z (2 months ago)
Last Synced: 2024-12-21T23:49:34.697Z (about 13 hours ago)
Topics: authentication, authorization, cloudinary, hook-form, hook-form-zod, jwt, nextjs14, nextui, quill-editor, reactjs, social-media, tanstack-react-query, typescript, vercel
Language: TypeScript
Homepage: https://pawprints-and-tales.vercel.app/
Size: 703 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

---

# Pawprints & Tales

[Live Link](https://pawprints-and-tales.vercel.app/)

## To test the api here is the admin credentials:

```plaintext
{
"email": "[email protected]",
"password": "admin123"
}
```

## To test the api here is the user credentials:

```plaintext
{
"email": "[email protected]",
"password": "user123"
}
```

## Introduction

Pawprints & Tales is a frontend web application designed to provide pet lovers and owners with an engaging and informative platform for accessing pet care tips and heartwarming stories. This application offers a user-friendly and visually appealing interface where users can browse through essential pet care advice, from proper nutrition and grooming to exercise and veterinary care. Alongside these practical guides, the platform shares inspiring stories of pet adoption, rescue, and the deep bonds between pets and their humans. With a focus on creating an enjoyable experience for all pet owners, the site is accessible across devices, ensuring a seamless experience whether on mobile, tablet, or desktop.

## Project Description

This project focuses on developing a dynamic frontend application for Pawprints & Tales, designed to deliver practical pet care tips and touching stories to pet enthusiasts. The application offers a well-organized and intuitive interface that makes it easy for users to access valuable advice on maintaining their pets' health and well-being. From nutrition and grooming to veterinary visits, users will find helpful information at their fingertips.

In addition to these care tips, the platform features heartwarming tales of rescue and adoption, emphasizing the loyalty and love shared between pets and their owners. The responsive design ensures that users can enjoy the platform on any device, making it accessible and enjoyable to navigate. Overall, Pawprints & Tales serves as both an informative and emotionally engaging resource for pet owners, providing a comprehensive solution to meet the needs of a growing community of pet lovers.

## Features

- Authentication and Authorization
- Role based dashboards
- An user can create,update and delete a post
- An user can create,update and delete a comment
- An Admin can manage users and post
- Allows user to filter,search specific post
- Allows user to pay for premium posts
- Initiates payment with aamarpay

## Technology Stack

- Programming Language: TypeScript
- Frontend : Next.js 14
- Styling: Tailwind CSS
- UI Components: Next UI
- Validation Library: Zod
- Data Fetching: Tanstack Query
- Animations: Framer Motion
- Payment Method: aamarpay
- Deployment: Vercel

### Prerequisites

- Node.js
- npm(or yarn)

### Installation Steps

**Follow this simple step to clone the project:**

```bash
git clone https://github.com/GGTuran/pet-care-client
```

**Now install the dependencies of the project:**

```bash
npm install
```

### Configuration

1. Create a `.env` file in the root directory of the project.
2. Add necessary configuration variables in the `.env` file.
Example:

```bash

NEXT_PUBLIC_BASE_API = backend url
NEXT_PUBLIC_BASE_URL = frontend url

```

## Start the server

**You can run the server in development mode**

```
npm run dev
```

## Project Structure

- **src/**: Contains application source code, including Redux services.
- **components/**: Contains React components.
- **pages/**: Contains React.js pages.
- **redux/**: Contains Redux slices and api.
- **routes/**: Contains all routing.
- **types/**: Contains all type.
- **schemas/**: Contains all schema.

# Usage

## Getting Started

To start using the Pawprints & Tales website, follow these steps:

1. **Access the Website**: Navigate to the [Pawprints & Tales](https://pawprints-and-tales.vercel.app/) using your web browser.

2. **Browse Available Posts**:

- On the homepage, you can view a list of posts.
- Use the search bar to filter post by name, content, or category.
- Apply filters to refine your search based on category of post.

3. **Premium Posts **:

- User can pay for premium posts.

## Error Handling

The API uses standard HTTP status codes to indicate the success or failure of an API request. Common status codes include:

- `200 OK`: The request was successful.
- `201 Created`: The resource was successfully created.
- `400 Bad Request`: The request could not be understood or was missing required parameters.
- `401 Unauthorized`: Authentication failed or user does not have permissions for the requested operation.
- `403 Forbidden`: Authentication succeeded but authenticated user does not have access to the requested resource.
- `404 Not Found`: The requested resource could not be found.
- `500 Internal Server Error`: An error occurred on the server..