https://github.com/dev-sire/visage-studios
VisageStudios: An online Cloud-based Photo editor to store your visuals to Cloudinary!
https://github.com/dev-sire/visage-studios
Last synced: 3 months ago
JSON representation
VisageStudios: An online Cloud-based Photo editor to store your visuals to Cloudinary!
- Host: GitHub
- URL: https://github.com/dev-sire/visage-studios
- Owner: dev-sire
- License: mit
- Created: 2024-06-14T16:03:07.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-15T13:20:55.000Z (about 1 year ago)
- Last Synced: 2025-01-29T09:41:10.083Z (5 months ago)
- Language: TypeScript
- Homepage:
- Size: 146 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📷 Visage Studio
A Cloud Based Platform for building a dynamic image gallery with Cloudinary.
Features include:
* Gallery view of all Photobox-uploaded images
* Image viewer with AI-powered editing
* Filters and Effects
* Creations including Collages, Animations, & Color Pop
## What's Inside
Technology used to build Photobox includes:
* Next.js App Router
* React Server Components for initial resource queries
* Suspense loading states
* Styling with Tailwind CSS
* Components using shadcn/ui
* Request management with Tanstack React Query
* Cloudinary for image storage, optimization, and transformation
## Getting Started
1. Create a new local project
```
npx create-next-app@latest https://github.com/dev-sire/Visage-Studios VisageStudio
```
You can also fork or clone the project manually!
2. Create a .env.local file or configure your environment variables to include:
```
NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME=""
NEXT_PUBLIC_CLOUDINARY_API_KEY=""
CLOUDINARY_API_SECRET=""
```
3. Install dependencies and start the project.
```
npm install
npm run dev
```
And you should now be running Photobox at http://localhost:3000/!
## Using Photobox
To start using Photobox, simply upload some images! The Upload button can be found on the top right of the library page.
After uploading, the image should now show up in your gallery where you can either start adding Creations from your image or edit it by navigating to a particular image.
Photobox takes advantage of both folders and tags to organize the images in your Cloudinary account. By default, all images are uploaded to a "photobox" folder and tagged with "photobox" and other tags prepended with "photobox-". This makes it easy to keep track of what images should be included in Photobox without cluttering your existing account.
## Configuration
Photobox ships with some default configurations to help you get started, but is
customizable based on your needs or preferences.
### Customization
To personalize your Photobox without manually updating the code, a few options
are made available for configuration.
The default values used for these are:
```jsx
const config = {
title: 'Photobox'
logo: ,
};
```
You can configure these values inside of the `theme.config.tsx` file as needed:
```jsx
const config = {
title: ''
logo: ,
}
```
### Asset Organization
Tags and folders are used to organize assets which are displayed in the app and
also used for functional needs like providing Favorites and Trash capabilities.
The default values used for these are:
```jsx
const config = {
assetsFolder: 'photobox',
assetsTag: 'photobox',
libraryTag: 'photobox-library',
creationTag: 'photobox-creation',
favoritesTag: 'photobox-favorite',
trashTag: 'photobox-trash',
};
```
There are two ways that you can configure these values, by using the `theme.config.tsx` file
or by configuring environment variables.
Using `theme.config.tsx`, add the following properties as needed:
```jsx
const config = {
assetsFolder: '';
assetsTag: '';
libraryTag: '';
creationTag: '';
favoritesTag: '';
trashTag: '';
}
```
Using environment variables, configure the following as needed:
```shell
NEXT_PUBLIC_CLOUDINARY_ASSETS_FOLDER=""
NEXT_PUBLIC_CLOUDINARY_ASSETS_TAG=""
NEXT_PUBLIC_CLOUDINARY_LIBRARY_TAG=""
NEXT_PUBLIC_CLOUDINARY_CREATION_TAG=""
NEXT_PUBLIC_CLOUDINARY_FAVORITES_TAG=""
NEXT_PUBLIC_CLOUDINARY_TRASH_TAG=""
```