Skip to content

rickystar04/PicPortal

Repository files navigation

PicPortal


CodeFactor

PicPortal is an innovative Chrome extension designed to enhance your daily internet browsing experience by transforming the standard new tab page into a vibrant display of stunning images and photographs. With PicPortal, every new tab you open becomes a gateway to visual inspiration and creativity.

Features

  • Dynamic Image Display: Each new tab greets you with a beautiful, high-resolution image from a curated collection, providing a refreshing start to your browsing sessions.
  • Seamless Integration: The extension is designed to blend smoothly with your Chrome browser, ensuring a seamless and intuitive user experience.
  • Custom API Integration The images are sourced from Unsplash, a platform for free-to-use, high-quality images. These images are delivered through a custom API hosted on Render, ensuring that you receive a fresh and diverse selection of visuals each time you open a new tab.
  • Personalized Categories PicPortal allows you to personalize your experience further by selecting categories of images that resonate with you. Choose from a variety of categories such as Nature, Architecture, Beaches, and more to tailor the visual inspiration on your new tab page to your preferences.
  • Favorites Synchronization: Keep your favorite images in sync across all your devices, ensuring your personal collection of inspiration is always at hand, no matter where you are or which device you're using.

Screenshots



Installation

  1. Clone the repository locally:
git clone https://github.com/rickystar04/PicPortal.git
  1. Navigate to the cloned directory via command prompt or terminal:
> cd PicPortal
  1. Install the necessary packages:
> npm install
  1. Build the project:
> npm run build
  1. Open Chrome and navigate to chrome://extensions/.
  2. Enable Developer Mode in the top right corner.
  3. Click on "Load unpacked extension" and select the build folder inside the cloned project directory.

Usage

After installation, whenever you open a new tab in Chrome, PicPortal's customized new tab page will be displayed.

Upcoming Features

  • Favorites Synchronization: In addition to adding images to your favorites for quick access, we are planning to implement synchronization of your favorites across multiple devices. This will allow you to access your curated collection of inspiring images no matter where you are or which device you're using.

  • Bookmarks: We are also working on a feature that will allow you to bookmark your favorite web pages directly from the new tab page. This will enable you to quickly navigate to your most visited sites and keep your favorite online content easily accessible.

Contributing

If you would like to contribute to the project, please submit a pull request or open an issue to discuss what you would like to change.

Note for Developers: The codebase uses the chrome.storage.sync API for saving data locally in Chrome. When running the project node with npm start, you will encounter an error due to the use of this API. Here's the recommended approach:

  • If you want to modify parts of the code that do not involve the chrome.storage.sync API, consider commenting out all parts of the program where it is used. This will allow you to run the project without encountering the error related to the chrome.storage API.
  • If your changes are related to the chrome.storage.sync API, you should rebuild the project's build file each time you want to see the changes applied by running npm run build. Then, reload the build in the Chrome extensions page to verify the functionality.

Please ensure that you test your changes thoroughly before submitting a pull request.

License

This project is released under the MIT License. For more details, see the LICENSE file in the repository.

Support

For support, you can open an issue in the GitHub repository or contact the maintainer at the email address provided in the GitHub profile.