{"id":29692745,"url":"https://github.com/lmcconneughey/post-ez","last_synced_at":"2026-04-09T19:50:56.951Z","repository":{"id":301289010,"uuid":"1008715486","full_name":"lmcconneughey/post-ez","owner":"lmcconneughey","description":"Post-EZ is a modern, full-stack Twitter/X clone built with performance, scalability, and clean developer experience in mind. The app supports posts (with image/video uploads), comments, likes, reposts, follows, and user profiles — all in a real-time, responsive social feed.","archived":false,"fork":false,"pushed_at":"2025-08-22T21:01:43.000Z","size":31802,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-22T23:52:18.051Z","etag":null,"topics":["clerk","express","nextjs","nodejs","postgresql","prisma","reactjs","socket-io","tailwindcss","webhooks","zod"],"latest_commit_sha":null,"homepage":"https://www.movemakersny.com","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/lmcconneughey.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,"zenodo":null}},"created_at":"2025-06-26T01:44:39.000Z","updated_at":"2025-08-22T21:01:45.000Z","dependencies_parsed_at":"2025-08-22T23:06:06.421Z","dependency_job_id":"d8e4f206-7229-4cab-86f7-40e48a52f94d","html_url":"https://github.com/lmcconneughey/post-ez","commit_stats":null,"previous_names":["lmcconneughey/post-ez"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lmcconneughey/post-ez","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lmcconneughey%2Fpost-ez","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lmcconneughey%2Fpost-ez/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lmcconneughey%2Fpost-ez/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lmcconneughey%2Fpost-ez/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lmcconneughey","download_url":"https://codeload.github.com/lmcconneughey/post-ez/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lmcconneughey%2Fpost-ez/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271745661,"owners_count":24813515,"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-08-23T02:00:09.327Z","response_time":69,"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":["clerk","express","nextjs","nodejs","postgresql","prisma","reactjs","socket-io","tailwindcss","webhooks","zod"],"created_at":"2025-07-23T08:01:24.957Z","updated_at":"2025-12-30T19:08:54.106Z","avatar_url":"https://github.com/lmcconneughey.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Postez\n\nA full-stack social media application for sharing posts and connecting with a community. This project was developed as a portfolio piece to demonstrate full-stack architecture, user authentication, real-time data handling, and media management.\n\n## 🚧 Status Update\n\nThe **Direct Messaging** feature is currently in active development. Core functionality, including sending and viewing conversations, is now complete.\n\nMy current focus is on implementing **real-time updates** with WebSockets. This will allow new messages to instantly appear in the UI for all participants, creating a seamless chat experience.\n\nEdit profile is up! The Edit Profile feature is up! Users can upload an avatar and cover image with crop and zoom. I'll be making improvements to this new feature.\n\n- **Live Site**: [https://movemakersny.com](https://www.google.com/search?q=https://movemakersny.com)\n\n- **Expected Behavior**: The live application will be available at the domain above once DNS propagation is complete.\n\n- **Immediate Access**: For a consistent experience, you can view the live site via a direct Vercel URL. This URL is provided in the project's settings, but for security, it is not shared publicly. Please use the main domain as the primary point of access.\n\nThank you for your patience and understanding!\n\n## ✨ Features\n\n- **User Authentication**: Secure user registration, sign-in, and sign-out powered by Clerk.\n\n- **Social Posting**: Users can create, view, and interact with posts.\n\n- **Image Uploads**: Image uploads and management using ImageKit.io.\n\n- **Real-time Updates**: Post updates and other events are handled in real time with WebSockets deployed via separate Node back-end.\n\n- **Responsive UI**: Adaptive user interface built with Next.js and Tailwind CSS.\n\n- **Database**: Data management using Prisma with a PostgreSQL database.\n\n## 🚀 Technologies Used\n\n- **Frontend**: [Next.js], [React], [Tailwind CSS]\n\n- **Backend**: [Next.js API Routes], [node]\n\n- **Database**: [PostgreSQL]managed by [Prisma]\n\n- **Authentication**: [Clerk]\n\n- **Media Management**: [ImageKit.io]\n\n- **Real-time Communication**: [WebSockets]\n\n- **Deployment**: [Vercel]\n\n## ⚙️ Project Setup\n\nTo run this project locally, follow these steps:\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/en/download/) (v18 or higher)\n\n- [npm](https://www.npmjs.com/) or [Yarn](https://yarnpkg.com/)\n\n- A PostgreSQL database instance\n\n### 1. Clone the repository\n\n```\ngit clone\ncd postez\n\n```\n\n### 2. Install dependencies\n\n```\nnpm install\n# or\nyarn install\n\n```\n\n### 3. Configure environment variables\n\nCreate a `.env` file in the root of the project and add your configurations. This project uses the following services:\n\n```\n# Database\nDATABASE_URL=\"postgresql://user:password@host:port/database?schema=public\"\n\n# Clerk\nNEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...\nCLERK_SECRET_KEY=sk_test_...\n\n# ImageKit\nNEXT_PUBLIC_IMAGEKIT_URL_ENDPOINT=[https://ik.imagekit.io/](https://ik.imagekit.io/)...\nIMAGEKIT_PRIVATE_KEY=private_...\n\n# WebSockets\n# Add your WebSocket connection URL here\nWEBSOCKET_URL=ws://localhost:3001\n\n```\n\n### 4. Run database migrations\n\nUse Prisma to push your database schema and seed data.\n\n```\nnpx prisma migrate dev --name init\n\n```\n\n### 5. Run the development server\n\n```\nnpm run dev\n# or\nyarn dev\n\n```\n\nThe application will be running at `http://localhost:3000`.\n\n## 🤝 Contact\n\n- **\\[Lawrence McConneughey\\]**\n\n- **\\[(https://www.linkedin.com/in/lawrence-mcconneughey/)\\]**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flmcconneughey%2Fpost-ez","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flmcconneughey%2Fpost-ez","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flmcconneughey%2Fpost-ez/lists"}