photocrate - GitLite

KO | EN

gitlite — search

#react #typescript #go #android #machine-learning #rust #deep-learning #linux #docker #nodejs #windows #vue #ios #open-source

photocrate

(★ 148)

Photo library and interactive editor built with Next.js & Cloudinary

파일 탐색기

최종 버전 다운로드 (.zip)

- android-chrome-192x192.png
- android-chrome-512x512.png
- apple-touch-icon.png
- browserconfig.xml
- favicon-1024x1024.png
- favicon-16x16.png
- favicon-32x32.png
- favicon.ico
- icon-1024x1024.png
- mstile-150x150.png
- safari-pinned-tab.svg
- site.webmanifest
- - globals.css
  - layout.tsx
  - providers.tsx
- - use-keydown.ts
  - use-resources.ts
- - cloudinary.ts
  - config.tsx
  - creations.ts
  - utils.ts
- - cloudinary.ts
  - config.ts
.all-contributorsrc
.env.example
.eslintrc.json
.gitignore
components.json
LICENSE
next.config.js
package-lock.json
package.json
postcss.config.js
README.md
tailwind.config.ts
theme.config.tsx
tsconfig.json

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/cloudinary-community/photocrate

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd photocrate

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm run dev

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 📷 PhotoCrate

[![All Contributors](https://img.shields.io/badge/all_contributors-2-orange.svg?style=flat-square)](https://raw.githubusercontent.com/cloudinary-community/photocrate/main/)

Google Photos clone for building a dynamic image gallery with Cloudinary.

Features include:
* Gallery view of all PhotoCrate-uploaded images
* Image viewer with AI-powered editing
* Filters and Effects
* Creations including Collages, Animations, & Color Pop
* Media Management

## What's Inside

Technology used to build PhotoCrate 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 -e https://github.com/cloudinary-community/photocrate photocrate
```

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="<Your Cloud Name>"
NEXT_PUBLIC_CLOUDINARY_API_KEY="<Your API Key>"
CLOUDINARY_API_SECRET="<Your API Secret>"
```

3. Install dependencies and start the project.

```
npm install
npm run dev
```

And you should now be running PhotoCrate at http://localhost:3000/!

## Using PhotoCrate

To start using PhotoCrate, 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.

PhotoCrate takes advantage of both folders and tags to organize the images in your Cloudinary account. By default, all images are uploaded to a "photocrate" folder and tagged with "photocrate" and other tags prepended with "photocrate-". This makes it easy to keep track of what images should be included in PhotoCrate without cluttering your existing account.

## Configuration

PhotoCrate ships with some default configurations to help you get started, but is
customizable based on your needs or preferences.

### Customization

To personalize your PhotoCrate without manually updating the code, a few options
are made available for configuration.

The default values used for these are:

```jsx
const config = {
  title: 'PhotoCrate'
  logo: <Focus className="w-6 h-6" />,
};
```

You can configure these values inside of the `theme.config.tsx` file as needed:

```jsx
const config = {
  title: '<Your Title>'
  logo: <YourLogo />,
}
```

### 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:  'photocrate',
  assetsTag: 'photocrate',
  libraryTag: 'photocrate-library',
  creationTag: 'photocrate-creation',
  favoritesTag: 'photocrate-favorite',
  trashTag: 'photocrate-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: '<Your Folder>';
  assetsTag: '<Your Tag>';
  libraryTag: '<Your Tag>';
  creationTag: '<Your Tag>';
  favoritesTag: '<Your Tag>';
  trashTag: '<Your Tag>';
}
```

Using environment variables, configure the following as needed:

```shell
NEXT_PUBLIC_CLOUDINARY_ASSETS_FOLDER="<Your Folder>"
NEXT_PUBLIC_CLOUDINARY_ASSETS_TAG="<Your Tag>"
NEXT_PUBLIC_CLOUDINARY_LIBRARY_TAG="<Your Tag>"
NEXT_PUBLIC_CLOUDINARY_CREATION_TAG="<Your Tag>"
NEXT_PUBLIC_CLOUDINARY_FAVORITES_TAG="<Your Tag>"
NEXT_PUBLIC_CLOUDINARY_TRASH_TAG="<Your Tag>"
```

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<table>
  <tbody>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="https://colbyfayock.com/newsletter"><img src="https://avatars.githubusercontent.com/u/1045274?v=4?s=100" width="100px;" alt="Colby Fayock"/><br /><sub><b>Colby Fayock</b></sub></a><br /><a href="https://github.com/cloudinary-community/photocrate/commits?author=colbyfayock" title="Code">💻</a> <a href="https://github.com/cloudinary-community/photocrate/commits?author=colbyfayock" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://nickyt.co"><img src="https://avatars.githubusercontent.com/u/833231?v=4?s=100" width="100px;" alt="Nick Taylor"/><br /><sub><b>Nick Taylor</b></sub></a><br /><a href="https://github.com/cloudinary-community/photocrate/commits?author=nickytonline" title="Code">💻</a></td>
    </tr>
  </tbody>
</table>

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!