https://github.com/basia1111/projectshowcase-v2
ProjectShowcase is a dynamic Next.js application designed to empower users to showcase their creative projects.
https://github.com/basia1111/projectshowcase-v2
cloudinary next15 nextauthv5 react tailwindcss typescript
Last synced: 22 days ago
JSON representation
ProjectShowcase is a dynamic Next.js application designed to empower users to showcase their creative projects.
- Host: GitHub
- URL: https://github.com/basia1111/projectshowcase-v2
- Owner: basia1111
- Created: 2024-12-17T10:27:33.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-01-02T10:32:00.000Z (9 months ago)
- Last Synced: 2025-02-13T08:52:47.388Z (8 months ago)
- Topics: cloudinary, next15, nextauthv5, react, tailwindcss, typescript
- Language: TypeScript
- Homepage: https://project-showcase-pied.vercel.app
- Size: 346 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ProjectShowcase
**ProjectShowcase** is a dynamic Next.js application that enables users to create, explore, and interact with projects shared by the community. Built with cutting-edge web technologies, it offers seamless authentication, robust filtering options, and an intuitive user experience.
## Features
### Authentication
- **NextAuth v5:** Supports credentials-based authentication.
- **Google OAuth Integration:** Users can log in securely with their Google accounts.
### User Functionality
- **Create Projects:** Share your work with the community by creating detailed project entries.
- **User Profile Dashboard:** Manage your projects and view your activity through a personalized dashboard.
- **Follow Users:** Stay updated by following other creators.
- **Like Projects:** Show appreciation by liking your favorite projects.
### Explore Projects
- **Category Filtering:** Browse projects based on specific categories.
- **Search Filter:** Quickly find projects using keywords.
- **Sorting Options:** Sort projects by popularity, date, or other criteria.
- **Pagination:** Navigate through large datasets efficiently.
### Media Management
- **Cloudinary Integration:** Store and manage user and project images seamlessly using Cloudinary.
### Responsive Design
- Fully optimized for desktop, tablet, and mobile devices, ensuring a seamless user experience.
## Tech Stack
- **Next.js:** Framework for server-side rendering and React-based web applications.
- **TypeScript:** Strongly typed programming language for safer and scalable code.
- **Tailwind CSS:** Utility-first CSS framework for rapid UI development.
- **Cloudinary:** Cloud-based media management for storing and retrieving images.
- **NextAuth v5:** Authentication solution for secure user logins.
- **Vercel:** Hosting for fast, reliable deployment.
## Setup
1. **Clone the Repository**:
```bash
git clone https://github.com/your-repo/project-showcase.git
cd project-showcase
```
2. **Install Dependencies**:
```bash
npm install
```
3. **Environment Variables**:
Create a `.env.local` file in the root directory and add the following:
```env
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
API_URL="http://localhost:3000/"
MONGODB_URI=
CLOUDINARY_CLOUD_NAME=
CLOUDINARY_API_KEY=
CLOUDINARY_API_SECRET=
NEXTAUTH_URL="http://localhost:3000"
```
4. **Run the Development Server**:
```bash
npm run dev
```
Visit [http://localhost:3000](http://localhost:3000) in your browser.
5. **Build for Production**:
```bash
npm run build
```
Deploy the build folder to your preferred hosting service.
## Demo
Check out the live application: [ProjectShowcase](https://project-showcase-pied.vercel.app/explore)
## Contributing
Contributions are welcome! To contribute:
1. Fork the repository.
2. Create a new branch.
3. Commit your changes.
4. Push to your branch and create a pull request.
## License
This project is licensed under the MIT License. See the LICENSE file for details.
---
**Happy showcasing!**