{"id":24156369,"url":"https://github.com/rushikeshg25/BidRealm","last_synced_at":"2025-09-20T00:32:46.928Z","repository":{"id":245618677,"uuid":"818772876","full_name":"rushikeshg25/BidRealm","owner":"rushikeshg25","description":"Bidding and Auctions made Easy","archived":false,"fork":false,"pushed_at":"2025-03-02T05:41:13.000Z","size":592,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-08T17:01:55.669Z","etag":null,"topics":["nextjs","prisma","redis","turborepo","websocket"],"latest_commit_sha":null,"homepage":"","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/rushikeshg25.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-06-22T20:26:55.000Z","updated_at":"2025-04-03T12:43:19.000Z","dependencies_parsed_at":"2024-06-23T03:00:07.823Z","dependency_job_id":"ed5012a3-54d6-4a84-80d2-eb2c8f5b33da","html_url":"https://github.com/rushikeshg25/BidRealm","commit_stats":null,"previous_names":["rushikeshg25/bidrealm-turbo","rushikeshg25/bidrealm"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rushikeshg25/BidRealm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rushikeshg25%2FBidRealm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rushikeshg25%2FBidRealm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rushikeshg25%2FBidRealm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rushikeshg25%2FBidRealm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rushikeshg25","download_url":"https://codeload.github.com/rushikeshg25/BidRealm/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rushikeshg25%2FBidRealm/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276022568,"owners_count":25571820,"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-19T02:00:09.700Z","response_time":108,"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":["nextjs","prisma","redis","turborepo","websocket"],"created_at":"2025-01-12T13:16:46.095Z","updated_at":"2025-09-20T00:32:46.893Z","avatar_url":"https://github.com/rushikeshg25.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# BidRealm\n\nBidRealm is a real-time auction platform built with modern web technologies.\n\n\n\nhttps://github.com/user-attachments/assets/7d8cb7e4-a924-4222-9042-cbdb16295aae\n\n\n\n## Architecture Overview\n\u003cimg width=\"871\" alt=\"BidRealm Arch\" src=\"https://github.com/user-attachments/assets/58554537-48f1-453a-a895-9fa07cb2c72a\"\u003e\n\n\nSystem consists of the following components:\n\n1. **Next Client**: The front-end application built with Next.js.\n2. **Express WS Server**: A WebSocket server handling real-time communication.\n3. **Postgres DB**: The primary database for storing user data, auctions, and bids.\n4. **Message Queue**: A Redis-based queue for handling email notifications.\n5. **Email Notification Worker**: A service responsible for sending email notifications.\n\n## Key Features\n\n- Real-time bidding using WebSockets\n- Auction and bid creation\n- Email notifications for auction events (winning, outbid, auction end)\n- User authentication and session management\n\n## Technologies Used\n\n- Next.js for the client-side application\n- Express.js for the WebSocket server\n- PostgreSQL and PrismaORM for data persistence\n- Redis for message queue to process Emails\n- WebSockets(ws) for real-time communication\n- Lucia for Auth\n- UploadThing for Image Upload\n- NodeMailer for Emails\n- Turborepo\n- Toast Notifications(react-hot-toast), Tailwind, zod, zustand, shadcn-ui\n\n## Getting Started\n\nFollow these steps to set up Bid Realm for local development:\n\n1. Clone the repository:\n```\ngit clone https://github.com/rushikeshg25/BidRealm-turbo.git\ncd BidRealm-turbo\n```\n3. Install dependencies:\n```\nyarn\n```\n5. Set up environment variables:\n- Copy the `.env.example` file in the `packages/db` directory and all app directories to `.env`.\n- Fill in the necessary environment variables in each `.env` file.\n\n4. Set up the database:\n```\nyarn prisma migrate dev\nyarn prisma generate\n```\n\n6. Start the development server:\n```\nyarn run dev\n```\nThe application should now be running on `http://localhost:3000` \n\n## Contributing\n\nWe welcome contributions to Bid Realm!.Please follow the getting started guide to get started. Please leave a Star ⭐\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frushikeshg25%2FBidRealm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frushikeshg25%2FBidRealm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frushikeshg25%2FBidRealm/lists"}