{"id":30899322,"url":"https://github.com/karan-develops/local-link","last_synced_at":"2025-09-09T03:09:07.455Z","repository":{"id":309697130,"uuid":"1025534942","full_name":"Karan-develops/Local-Link","owner":"Karan-develops","description":"A hyper-local digital noticeboard for Indian neighborhoods. Post and view public events \u0026 notices relevant to your nearby area.","archived":false,"fork":false,"pushed_at":"2025-08-22T08:33:38.000Z","size":721,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-22T10:31:57.853Z","etag":null,"topics":["full-stack","nextjs"],"latest_commit_sha":null,"homepage":"https://local-link-karan.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/Karan-develops.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-07-24T12:00:07.000Z","updated_at":"2025-08-22T08:33:41.000Z","dependencies_parsed_at":"2025-08-13T10:30:30.602Z","dependency_job_id":"575f62dd-b8e2-4a17-b5f0-52053e9a4d4b","html_url":"https://github.com/Karan-develops/Local-Link","commit_stats":null,"previous_names":["karan-develops/local-link"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Karan-develops/Local-Link","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karan-develops%2FLocal-Link","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karan-develops%2FLocal-Link/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karan-develops%2FLocal-Link/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karan-develops%2FLocal-Link/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Karan-develops","download_url":"https://codeload.github.com/Karan-develops/Local-Link/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karan-develops%2FLocal-Link/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274238008,"owners_count":25247101,"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-09T02:00:10.223Z","response_time":80,"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":["full-stack","nextjs"],"created_at":"2025-09-09T03:09:06.192Z","updated_at":"2025-09-09T03:09:07.441Z","avatar_url":"https://github.com/Karan-develops.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Local Link - A hyper-local digital noticeboard\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [Features](#features)\n- [Technologies Used](#📚Tech-Stack)\n- [Installation](#💻Installation)\n- [Usage](#usage)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Introduction\n\nA hyper-local digital noticeboard for Indian neighborhoods. Post and view public events \u0026 notices relevant to your nearby area.\n\n![banner](https://raw.githubusercontent.com/Karan-develops/Local-Link/refs/heads/main/App.png)\n\n## 📚Tech-Stack\n\n- **(Next Full Stack):**\n  - React.js\n  - Next.js\n  - Shadcn-ui\n  - TailwindCSS\n  - TypeScript\n  - Zod - Form Validation\n  - Framer-motion\n  - Firebase\n- **Database:**\n  - Neon\n  - PostgreSQL\n  - Firebase\n  - Cloudinary\n- **Version Control:**\n  - Git\n\n```\n## 📁 File Structure :\nDirectory structure:\n└── next/\n    ├── README.md\n    ├── components.json\n    ├── eslint.config.mjs\n    ├── next.config.ts\n    ├── package.json\n    ├── postcss.config.mjs\n    ├── tsconfig.json\n    ├── actions/\n    │   ├── comments.actions.ts\n    │   ├── dashboard.actions.ts\n    │   ├── helper.actions.ts\n    │   ├── notices.actions.ts\n    │   ├── notifications.actions.ts\n    │   └── user.actions.ts\n    ├── app/\n    │   ├── globals.css\n    │   ├── layout.tsx\n    │   ├── page.tsx\n    │   ├── api/\n    │   │   ├── comments/\n    │   │   │   └── route.ts\n    │   │   ├── create-user/\n    │   │   │   └── route.ts\n    │   │   ├── dashboard/\n    │   │   │   └── route.ts\n    │   │   ├── notices/\n    │   │   │   ├── route.ts\n    │   │   │   └── [id]/\n    │   │   │       ├── route.ts\n    │   │   │       └── upvote/\n    │   │   │           └── route.ts\n    │   │   ├── notifications/\n    │   │   │   └── route.ts\n    │   │   ├── post-notices/\n    │   │   │   └── route.ts\n    │   │   ├── set-session/\n    │   │   │   └── route.ts\n    │   │   └── upload-on-cloudinary/\n    │   │       └── route.ts\n    │   ├── auth/\n    │   │   └── page.tsx\n    │   ├── dashboard/\n    │   │   └── page.tsx\n    │   ├── map/\n    │   │   └── page.tsx\n    │   ├── notices/\n    │   │   ├── page.tsx\n    │   │   └── [id]/\n    │   │       └── page.tsx\n    │   ├── post/\n    │   │   └── page.tsx\n    │   └── user/\n    │       └── [id]/\n    │           └── page.tsx\n    ├── components/\n    │   ├── AuthForm.tsx\n    │   ├── AuthProvider.tsx\n    │   ├── CardSkeleton.tsx\n    │   ├── CategoryFilterSection.tsx\n    │   ├── DashboardView.tsx\n    │   ├── Footer.tsx\n    │   ├── Hero.tsx\n    │   ├── LocationProvider.tsx\n    │   ├── MapView.tsx\n    │   ├── Navbar.tsx\n    │   ├── NoticeDetails.tsx\n    │   ├── NoticesView.tsx\n    │   ├── PostNoticeForm.tsx\n    │   ├── SessionWatcher.tsx\n    │   ├── ToggleTheme.tsx\n    │   ├── UserProfile.tsx\n    │   └── ui/\n    │       ├── avatar.tsx\n    │       ├── badge.tsx\n    │       ├── button.tsx\n    │       ├── card.tsx\n    │       ├── dropdown-menu.tsx\n    │       ├── input.tsx\n    │       ├── label.tsx\n    │       ├── popover.tsx\n    │       ├── scroll-area.tsx\n    │       ├── select.tsx\n    │       ├── separator.tsx\n    │       ├── sheet.tsx\n    │       ├── skeleton.tsx\n    │       ├── sonner.tsx\n    │       ├── switch.tsx\n    │       ├── tabs.tsx\n    │       └── textarea.tsx\n    ├── hooks/\n    │   └── use-auth.ts\n    ├── lib/\n    │   ├── cloudinary.ts\n    │   ├── prisma.ts\n    │   ├── utils.ts\n    │   ├── validations.ts\n    │   └── firebase/\n    │       ├── firebase-admin.ts\n    │       ├── firebase-auth.ts\n    │       ├── firebase.ts\n    │       └── upload-image.ts\n    ├── prisma/\n    │   ├── schema.prisma\n    │   └── migrations/\n    │       ├── migration_lock.toml\n    │       ├── 20250726095710_init/\n    │       │   └── migration.sql\n    │       ├── 20250729115813_notices/\n    │       │   └── migration.sql\n    │       ├── 20250812095037_user_profile/\n    │       │   └── migration.sql\n    │       └── 20250812101829_user_profile/\n    │           └── migration.sql\n    ├── types/\n    │   └── types.ts\n    └── utils/\n        ├── distance.ts\n        ├── refreshSessionCookie.ts\n        └── setSessionCookie.ts\n```\n\n### Environment Variables\n\n| Variable                                      | Description                                             |\n| :-------------------------------------------- | :------------------------------------------------------ |\n| ----------------`DATABASE`------------------- | ------------------`DATABASE`--------------------------  |\n| DATABASE_URL                                  | Database URL from neon again make a free account        |\n| ----------------`FIREBASE`------------------- | ------------------`FIREBASE`--------------------------  |\n| NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN              | Create Firebase Project To Get this key                 |\n| NEXT_PUBLIC_FIREBASE_PROJECT_ID               | Create Firebase Project To Get this key                 |\n| NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET           | Create Firebase Project To Get this key                 |\n| NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID      | Create Firebase Project To Get this key                 |\n| NEXT_PUBLIC_FIREBASE_APP_ID                   | Create Firebase Project To Get this key                 |\n| NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID           | Create Firebase Project To Get this key                 |\n| ----------------`LOCATION`------------------- | ------------------`LOCATION`--------------------------- |\n| NEXT_PUBLIC_NOMINATIM_URL                     | Contact me to get this URL                              |\n| -------------`FIREBASE-ADMIN`---------------- | ------------------`FIREBASE-ADMIN`--------------------- |\n| FIREBASE_PROJECT_ID                           | Download Create Admin Private Keys json file            |\n| FIREBASE_CLIENT_EMAIL                         | Download Create Admin Private Keys json file            |\n| FIREBASE_PRIVATE_KEY                          | Download Create Admin Private Keys json file            |\n\n# 💻Installation\n\n## 🔥 Next-JS\n\nTo run this project locally, follow these steps:\n\n1.  Clone the repository:\n    `git clone https://github.com/Karan-develops/Local-Link`\n2.  Navigate to the project directory:\n    `cd next`\n3.  Install the dependencies:\n    `npm install`\n4.  Set up environment variables: - Create a `.env` file in the `next` directory, - Add the Variables given in above `next` Table.\n5.  Start the development server:\n    `npm run dev`\n\n## Usage\n\n- Open your browser and navigate to `http://localhost:3000` for next.\n- Register a new account or log in with existing credentials.\n- Explore the features and functionalities of the Local Link Project.\n\n## Contributing\n\nContributions are welcome! Please follow these steps to contribute:\n- Clone or fork this repo\n\u003e `Run` [ git clone ` https://github.com/Karan-develops/Local-Link `]\n\n1. Fork the repository.\n2. Create a new branch:\n   `git checkout -b feature/your-feature-name`\n3. Make your changes and commit them:\n   `git commit -m \"Add your message\"`\n4. Push to the branch:\n   `git push origin feature/your-feature-name`\n5. Open a pull request.\n\n## 🔒 License\n\nThis repository is open source and under [MIT](https://choosealicense.com/licenses/mit/) License.\n\n--- **_Lets Build \u0026 Grow, Have a Good Day_** **😊** ---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaran-develops%2Flocal-link","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkaran-develops%2Flocal-link","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaran-develops%2Flocal-link/lists"}