# flutterStudy

**Repository Path**: korean/flutter-study

## Basic Information

- **Project Name**: flutterStudy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-11-08
- **Last Updated**: 2023-12-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Favorite Books App
This project consists of 5 main pages: the home page, detail page, search page, my favorite books page, and book categories page, developed using the Google Books API. During the development process of the project, the MVVM architecture and Provider State Management method were utilized.


## The Libraries and Technologies
- MVVM (Model-View-ViewModel) Architecture: A software architectural pattern that separates the application's data (model), user interface (view), and logic (view model) components to ensure separation of concerns and maintainability. (https://learn.microsoft.com/en-us/dotnet/architecture/maui/mvvm)
- Google Books API: An API provided by Google that allows access to a vast collection of books and related information. (https://developers.google.com/books/docs/v1/using)
- mobx => https://pub.dev/packages/mobx
- flutter_mobx => https://pub.dev/packages/flutter_mobx
- provider => https://pub.dev/packages/provider
- mobx_codegen => https://pub.dev/packages/mobx_codegen
- build_runner => https://pub.dev/packages/build_runner
- flutter_svg => https://pub.dev/packages/flutter_svg
- auto_size_text => https://pub.dev/packages/auto_size_text
- http => https://pub.dev/packages/http

## Application Pages
### Onboard
- The application includes three introductory screens that provide brief descriptions and visuals about the app.

<table>
  <tr>
    <td>Onboard Page One</td>
    <td>Onboard Page Two</td>
    <td>Onboard Page Three</td> 
  </tr>  
  <tr>
    <td><img src="github/screenshots/onboard-first.png" width=270 height=480></td>
    <td><img src="github/screenshots/onboard-second.png" width=270 height=480></td>
     <td><img src="github/screenshots/onboard-3.png" width=270 height=480></td>
  </tr>
</table>

### Home Page
- The introductory screens welcome the user with a combination of images and written headlines. Underneath the headlines, there are lists of trending and best-selling books. When clicked on any book in these lists, the user can transition to a detailed page that provides descriptions and information about the book.

<table>
  <tr>
    <td>Home Page One</td>
   <td>Home Page Two</td>
  </tr>  
  <tr>
    <td><img src="github/screenshots/book-home.png" width=270 height=480></td>
   <td><img src="github/screenshots/book-home-2.png" width=270 height=480></td>
  </tr>
</table>

### Book Categories Page
- This page lists the book categories obtained from the Google Books API. When a category is clicked, the page will display the books belonging to that category.

<table>
  <tr>
    <td>Categories Page </td>
   <td>Loading</td> 
    <td>Categories List</td>
  </tr>  
  <tr>
    <td><img src="github/screenshots/book-categories.png" width=270 height=480></td>
   <td><img src="github/screenshots/book-load.png" width=270 height=480></td>
    <td><img src="github/screenshots/book-categories-list.png" width=270 height=480></td>
  </tr>
</table>

### My Favorite Books Page
- When a book is clicked in the application, it will navigate to the book detail page. On the book detail page, there will be a heart icon that allows you to add the selected book to your favorites section. When you click the heart icon, the chosen book will be automatically listed in the "My Favorite Books" page. Later, you can visit this page and remove any book you desire from your favorites.

<table>
  <tr>
    <td>Favorites Page </td>

  </tr>  
  <tr>
    <td><img src="github/screenshots/book-favorite-page.png" width=270 height=480></td>

  </tr>
</table>

### Book Detail Page
- On the book detail page, there will be a heart icon that allows you to add the selected book to your favorites section. When you click the heart icon, the chosen book will be automatically listed in the "My Favorite Books" page. Later, you can visit this page and remove any book you desire from your favorites.

<table>
  <tr>
    <td>Book Detail Page </td>
      <td>Book Detail Bottomsheet </td>

  </tr>  
  <tr>
    <td><img src="github/screenshots/book-detail-page.png" width=270 height=480></td>
<td><img src="github/screenshots/book-bottom-shhet.png" width=270 height=480></td>
  </tr>
</table>

### Search Page
- This is the page where you can search for any desired book, category, or author. You can enter any keyword or term in the search bar to access the desired information.


<table>
  <tr>
    <td>Book Search Page </td>
      <td>Book Search List </td>

  </tr>  
  <tr>
    <td><img src="github/screenshots/book-search.png" width=270 height=480></td>
<td><img src="github/screenshots/book-search-list.png" width=270 height=480></td>
  </tr>
</table>

## ![warning (1)](https://github.com/furkanagess/book_app/assets/92018394/6b537bd1-f5d0-432f-92c4-1dc1e9f9ad6d) ![warning (1)](https://github.com/furkanagess/book_app/assets/92018394/6b537bd1-f5d0-432f-92c4-1dc1e9f9ad6d)  Technical Stuffs  ![warning (1)](https://github.com/furkanagess/book_app/assets/92018394/6b537bd1-f5d0-432f-92c4-1dc1e9f9ad6d) ![warning (1)](https://github.com/furkanagess/book_app/assets/92018394/6b537bd1-f5d0-432f-92c4-1dc1e9f9ad6d)

### Multi Provider
<table>
  <tr>
    <td>Multi Provider</td>
  </tr>  
  <tr>
    <td><img src="github/screenshots/multi-provider.png" width=1000 height=500></td>
  </tr>
</table>

### Service

<table>
  <tr>
    <td>Service</td>
  </tr>  
  <tr>
    <td><img src="github/codeshots/book-search-service.png" width=1000 height=700></td>
  </tr>
</table>

### Service-ViewModel

<table>
  
  <tr>
    <td>Service-ViewModel</td>
  </tr>  
  <tr>
    <td><img src="github/codeshots/book-search-viewmodel.png" width=1000 height=700></td>
  </tr>
</table>

### Service-View

<table>
  <tr>
    <td>Service-View </td>
  </tr>  
  <tr>
    <td><img src="github/codeshots/book-search-view.png" width=1000 height=700></td>
  </tr>
</table>

### Book Model
<table>
  <tr>
    <td>Book Model </td>
  </tr>  
  <tr>
    <td><img src="github/codeshots/book-model.png" width=1000 height=700></td>
  </tr>
</table>

### Folder Structure

<table>
  <tr>
    <td>Folder One </td>
      <td> Folder Two </td>

  </tr>  
  <tr>
    <td><img src="github/screenshots/folder-1.png" width=250 height=500></td>
<td><img src="github/screenshots/folder-2.png" width=250 height=500></td>
  </tr>
</table>

### Testing

<table>
  <tr>
    <td>Folder One </td>
   

  </tr>  
  <tr>
    <td><img src="github/codeshots/book-home-test.png" width=1000 height=700></td>
  </tr>
</table>

### Color Palette
<table>
  <tr>
    <td>App Color Palette </td>
  </tr>  
  <tr>
    <td><img src="github/codeshots/book-colors.png" width=1000 height=700></td>
  </tr>
</table>

## Will Be Added Soon

- Unit Tests & Integration Tests
- Local Storage
- Splash
- Shimmer Effects