{"id":20599567,"url":"https://github.com/devsrijit/poetic-echoes","last_synced_at":"2025-09-11T00:42:33.174Z","repository":{"id":216618731,"uuid":"741877506","full_name":"DevSrijit/Poetic-Echoes","owner":"DevSrijit","description":"Poetic Echoes: A Next.js-powered social media platform for poetry enthusiasts.Engage in threaded discussions, explore communities, and showcase your poetic prowess.Built with Clerk for authentication and a modular structure for easy customization.","archived":false,"fork":false,"pushed_at":"2024-02-02T19:39:14.000Z","size":233,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-06T15:50:51.349Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://poetic-echoes.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DevSrijit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-11T09:49:51.000Z","updated_at":"2024-01-12T14:54:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"c5b590cb-5b3a-45f5-9389-f185ddb169d4","html_url":"https://github.com/DevSrijit/Poetic-Echoes","commit_stats":null,"previous_names":["devsrijit/poetic-echoes"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DevSrijit/Poetic-Echoes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevSrijit%2FPoetic-Echoes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevSrijit%2FPoetic-Echoes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevSrijit%2FPoetic-Echoes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevSrijit%2FPoetic-Echoes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DevSrijit","download_url":"https://codeload.github.com/DevSrijit/Poetic-Echoes/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevSrijit%2FPoetic-Echoes/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274556161,"owners_count":25307506,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-10T02:00:12.551Z","response_time":83,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T08:33:23.144Z","updated_at":"2025-09-11T00:42:33.129Z","avatar_url":"https://github.com/DevSrijit.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Poetic Echoes\n\n![Poetic Echoes](https://cloud-ppyu19102-hack-club-bot.vercel.app/0_c4363f81-a2df-41ba-bfc1-60cb252df085.jpeg)\n\n\u003cdiv align=\"center\"\u003e\n\n  \u003cdiv\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-Next_JS-black?style=for-the-badge\u0026logoColor=white\u0026logo=nextdotjs\u0026color=000000\" alt=\"nextdotjs\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-MongoDB-black?style=for-the-badge\u0026logoColor=white\u0026logo=mongodb\u0026color=47A248\" alt=\"mongodb\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-Tailwind_CSS-black?style=for-the-badge\u0026logoColor=white\u0026logo=tailwindcss\u0026color=06B6D4\" alt=\"tailwindcss\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-Clerk-black?style=for-the-badge\u0026logoColor=white\u0026logo=clerk\u0026color=6C47FF\" alt=\"clerk\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-Shadcn_UI-black?style=for-the-badge\u0026logoColor=white\u0026logo=shadcnui\u0026color=000000\" alt=\"shadcnui\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-Zod-black?style=for-the-badge\u0026logoColor=white\u0026logo=zod\u0026color=3E67B1\" alt=\"zod\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/-Typescript-black?style=for-the-badge\u0026logoColor=white\u0026logo=typescript\u0026color=3178C6\" alt=\"typescript\" /\u003e\n  \u003c/div\u003e\n  \u003c/br\u003e\n\u003c/div\u003e\n\nPoetic Echoes is a social media platform designed for discovering and sharing poetry. It provides a space for poets and poetry enthusiasts to connect, engage, and explore the world of poetry. This README.md file provides an overview of the project structure, features, and credits.\n\n## Table of Contents\n\n- [Features](#features)\n- [Project Structure](#project-structure)\n- [Credits](#credits)\n\n## Features\n\n- **User Authentication**: Poetic Echoes uses [Clerk](https://clerk.dev/) for user authentication, providing a secure and seamless login experience.\n- **Threaded Discussions**: Users can create and participate in threaded discussions, allowing for in-depth conversations and replies.\n- **Search Functionality**: The search feature allows users to find specific posts or threads based on keywords or tags.\n- **Profile Pages**: Each user has a profile page where they can showcase their posts and engage with other users.\n- **Activity Feed**: The activity feed provides users with updates on recent posts, comments, and interactions.\n- **Responsive Design**: The site is fully responsive, ensuring a seamless experience across different devices and screen sizes.\n\n## ⚙️ Tech Stack\n\n- Next.js\n- MongoDB\n- Shadcn UI\n- TailwindCSS\n- Clerk\n- Webhooks\n- Serverless APIs\n- React Hook Form\n- Zod\n- TypeScript\n\n## 🔋 Features\n\n👉 **Authentication**: Authentication using Clerk for email, password, and social logins (Google and GitHub) with a comprehensive profile management system.\n\n👉 **Visually Appealing Home Page**: A visually appealing home page showcasing the latest threads for an engaging user experience.\n\n👉 **Create Posts Page**: A dedicated page for users to create posts, fostering community engagement\n\n👉 **Commenting Feature**: A commenting feature to facilitate discussions within posts.\n\n👉 **Nested Commenting**: Commenting system with nested posts, providing a structured conversation flow.\n\n👉 **User Search with Pagination**: A user search feature with pagination for easy exploration and discovery of other users.\n\n👉 **Activity Page**: Display notifications on the activity page when someone comments on a user's thread, enhancing user engagement.\n\n👉 **Profile Page**: User profile pages for showcasing information and enabling modification of profile settings.\n\n👉 **Blazing-Fast Performance**: Optimal performance and instantaneous page switching for a seamless user experience.\n\n👉 **Server Side Rendering**: Utilize Next.js with Server Side Rendering for enhanced performance and SEO benefits.\n\n👉 **MongoDB with Complex Schemas**: Handle complex schemas and multiple data populations using MongoDB.\n\n👉 **File Uploads with UploadThing**: File uploads using UploadThing for a seamless media sharing experience.\n\n👉 **Real-Time Events Listening**: Real-time events listening with webhooks to keep users updated.\n\n👉 **Middleware, API Actions, and Authorization**: Utilize middleware, API actions, and authorization for robust application security.\n\n👉 **Next.js Layout Route Groups**: New Next.js layout route groups for efficient routing\n\n👉 **Data Validation with Zod**: Data integrity with data validation using Zod\n\n👉 **Form Management with React Hook Form**: Efficient management of forms with React Hook Form for a streamlined user input experience.\n\nand many more, including code architecture and reusability improvements.\n\n## Project Structure\n\nThe project follows a modular structure, with different components and pages organized into separate files. Here is an overview of the main files and directories:\n\n- `components`: Contains reusable components used throughout the site, such as `ThreadCard`, `Bottombar`, `Topbar`, etc.\n- `app/(root)`: Contains the main pages of the application, including the home page, profile page, and thread page.\n- `constants`: Contains constants used throughout the application, such as sidebar links and profile tabs.\n- `layout.tsx`: Defines the layout of the site, including the top bar, sidebars, and bottom bar.\n- `globals.css`: Contains global CSS styles used throughout the site.\n\n## 🤸 Quick Start\n\nFollow these steps to set up the project locally on your machine.\n\n**Prerequisites**\n\nMake sure you have the following installed on your machine:\n\n- [Git](https://git-scm.com/)\n- [Node.js](https://nodejs.org/en)\n- [npm](https://www.npmjs.com/) (Node Package Manager)\n\n**Cloning the Repository**\n\n```bash\ngit clone https://github.com/devsrijit/poetic-echoes.git\ncd threads\n```\n\n**Installation**\n\nInstall the project dependencies using npm:\n\n```bash\nnpm install\n```\n\n**Set Up Environment Variables**\n\nCreate a new file named `.env` in the root of your project and add the following content:\n\n```env\nMONGODB_URL=\nCLERK_SECRET_KEY=\nUPLOADTHING_SECRET=\nUPLOADTHING_APP_ID=\nNEXT_CLERK_WEBHOOK_SECRET=\nNEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=\n```\n\nReplace the placeholder values with your actual credentials. You can obtain these credentials by signing up for the corresponding websites on [MongoDB](https://www.mongodb.com/), [Clerk](https://clerk.com/), and [Uploadthing](https://uploadthing.com/). \n\n**Running the Project**\n\n```bash\nnpm run dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) in your browser to view the project.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevsrijit%2Fpoetic-echoes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevsrijit%2Fpoetic-echoes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevsrijit%2Fpoetic-echoes/lists"}