{"id":15723280,"url":"https://github.com/mo-hassann/social-app","last_synced_at":"2025-05-13T04:54:51.815Z","repository":{"id":246990153,"uuid":"823842995","full_name":"mo-hassann/social-app","owner":"mo-hassann","description":"social media app with next js, hono, next-auth, react-query and drizzle orm ","archived":false,"fork":false,"pushed_at":"2024-08-26T11:47:11.000Z","size":1254,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-13T04:54:45.572Z","etag":null,"topics":["authjs","drizzle-orm","honojs","nextauth","nextjs","reactquery","social-media","social-media-app","tanstack-react-query"],"latest_commit_sha":null,"homepage":"https://social-m-app.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mo-hassann.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-07-03T20:51:35.000Z","updated_at":"2025-04-05T20:19:06.000Z","dependencies_parsed_at":"2024-08-25T16:27:18.540Z","dependency_job_id":"45142372-d30b-4903-9b29-a310d7add44d","html_url":"https://github.com/mo-hassann/social-app","commit_stats":null,"previous_names":["mo-hassann/social-app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mo-hassann%2Fsocial-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mo-hassann%2Fsocial-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mo-hassann%2Fsocial-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mo-hassann%2Fsocial-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mo-hassann","download_url":"https://codeload.github.com/mo-hassann/social-app/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253877505,"owners_count":21977643,"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","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":["authjs","drizzle-orm","honojs","nextauth","nextjs","reactquery","social-media","social-media-app","tanstack-react-query"],"created_at":"2024-10-03T22:10:55.615Z","updated_at":"2025-05-13T04:54:51.797Z","avatar_url":"https://github.com/mo-hassann.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![alt text](https://github.com/mo-hassann/my-portfolio/blob/master/public/projects-imgs/social.png)\n# Social Media App\n\nA modern social media application built using Next.js, Hono, Drizzle ORM, and React Query. This app allows users to connect, share posts, and engage with a community.\n\n## 📃 Table of Contents\n\n- [✨ Features](#-features)\n- [👩‍💻 Tech Stack](#-tech-stack)\n- [💻 Getting Started](#-getting-started)\n- [🛠️ Installation](#-️installation)\n- [📖 Usage](#-usage)\n- [💚 Contributing](#-contributing)\n- [📜 License](#-license)\n\n## ✨ Features\n\n- **User Authentication**: Secure sign-up and login with Auth JS.\n- **User Profiles**: Customizable profiles with avatars and bio.\n- **Posts**: Create, edit, and delete posts.\n- **Comments**: Comment on posts and engage with the community.\n- **Real-time Notifications**: Stay updated with real-time notifications for likes, comments, and new followers.\n- **Search**: Find users and posts using the search feature.\n\n## 👩‍💻 Tech Stack\n\n- **Next.js**: A React framework for building server-side rendering and static web applications.\n- **Auth.js**: Free and open source Authentication for the Web.\n- **Hono**: A lightweight web framework for building server-side applications with TypeScript.\n- **Drizzle ORM**: TypeScript-first ORM for type-safe database access.\n- **React Query**: Data-fetching library for managing server-state in React applications.\n- **Bun**: A fast JavaScript runtime that includes a package manager, task runner, and more.\n\n## 💻 Getting Started\n\nTo get a local copy of this project up and running, follow these steps.\n\n### ✔ Prerequisites\n\n- **Bun**: Ensure you have Bun installed. Follow the [official Bun installation guide](https://bun.sh/docs/installation).\n- PostgreSQL (or another supported SQL database)\n\n\n## 🛠️ Installation\n\n1. **Clone the repository:**\n\n    ```bash\n    git clone https://github.com/mo-hassann/social-app.git\n    cd social-app\n    ```\n\n2. **Install dependencies:**\n\n    Using Bun:\n\n    ```bash\n    bun install\n    ```\n\n3. **Set up environment variables:**\n\n    Create a `.env` file in the root directory and add the following variables:\n\n    ```env\n    DATABASE_URL=your_database_url\n    DATABASE_SECRET=your_database_secret\n    DRIZZLE_DATABASE_URL=your_database_url_for_drizzle\n    AUTH_SECRET=any_random_secret\n    NEXT_PUBLIC_APP_URL=http://localhost:3000\n    ```\n\n4. **Run database migrations:**\n\n    Ensure your database is running and then run:\n\n    ```bash\n    bun run migrate\n    ```\n\n5. **Start the development server:**\n\n    ```bash\n    bun dev\n    ```\n\n    Open [http://localhost:3000](http://localhost:3000) to view the app in your browser.\n\n\n## 📖 Usage\n\n### ✔ Running the app\n\n- **Development mode:** `bun dev`\n- **Production mode:** `bun run build \u0026\u0026 bun start`\n\n## 💚 Contributing\n\nWe welcome contributions to this project. Please follow these steps to contribute:\n\n1. **Fork the repository.**\n2. **Create a new branch** (`git checkout -b feature/your-feature-name`).\n3. **Make your changes** and commit them (`git commit -m 'Add some feature'`).\n4. **Push to the branch** (`git push origin feature/your-feature-name`).\n5. **Open a pull request**.\n\nPlease make sure to update tests as appropriate.\n\n## 📜 License\n\nDistributed under the MIT License. See [License](/LICENSE) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmo-hassann%2Fsocial-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmo-hassann%2Fsocial-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmo-hassann%2Fsocial-app/lists"}