{"id":27443036,"url":"https://github.com/abdulahad968/pulse-wire","last_synced_at":"2026-05-05T20:41:44.799Z","repository":{"id":287699291,"uuid":"965489217","full_name":"AbdulAHAD968/PULSE-WIRE","owner":"AbdulAHAD968","description":"News application using Th Guardian API.","archived":false,"fork":false,"pushed_at":"2025-04-13T16:37:11.000Z","size":3364,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-15T01:18:23.986Z","etag":null,"topics":["fullstack-development","guardian-api","javascript","newsapi","newsapp","react","theguardian","universeio","webdevelopment"],"latest_commit_sha":null,"homepage":"https://pulsewire-eight.vercel.app/","language":"JavaScript","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/AbdulAHAD968.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-04-13T09:27:32.000Z","updated_at":"2025-04-14T09:23:15.000Z","dependencies_parsed_at":"2025-04-13T12:25:17.246Z","dependency_job_id":"bb208df5-bf91-4889-8fcb-fd29e221d876","html_url":"https://github.com/AbdulAHAD968/PULSE-WIRE","commit_stats":null,"previous_names":["abdulahad968/pulse-wire"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdulAHAD968%2FPULSE-WIRE","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdulAHAD968%2FPULSE-WIRE/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdulAHAD968%2FPULSE-WIRE/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdulAHAD968%2FPULSE-WIRE/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AbdulAHAD968","download_url":"https://codeload.github.com/AbdulAHAD968/PULSE-WIRE/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248986316,"owners_count":21194025,"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":["fullstack-development","guardian-api","javascript","newsapi","newsapp","react","theguardian","universeio","webdevelopment"],"created_at":"2025-04-15T01:18:39.745Z","updated_at":"2026-05-05T20:41:44.771Z","avatar_url":"https://github.com/AbdulAHAD968.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📰 Pulse-Wire\n\n**Pulse-Wire** is a responsive single-page web application that delivers the latest headlines and news articles using **The Guardian Open Platform API**. Users can browse top headlines, search for specific news topics, and bookmark articles for later reading.\n\n---\n\n## 🌐 Live Demo\n\n[🔗 Click here to visit Pulse-Wire (demo link)](https://pulsewire-eight.vercel.app/) \n\n---\n\n## 🚀 Features\n\n- 🔎 Search for news by keywords\n- 📰 View latest top headlines from The Guardian\n- 🗂️ Auto-generated categories for visual appeal\n- 📱 Responsive UI for all devices\n- 💾 Bookmark functionality (optional)\n- 🔄 Retry option on network failure\n- 🌑 Placeholder content for missing data\n\n---\n\n## 📸 Screenshots\n![Landing Page](1.PNG)\n![Home Page](2.PNG)\n![Search Results](3.PNG)\n![Filters](4.PNG)\n\n---\n\n## 🧰 Tech Stack\n\n- **Frontend**: React.js (SPA)\n- **Styling**: CSS / Tailwind (optional)\n- **Data Source**: [The Guardian Open Platform](https://open-platform.theguardian.com/)\n- **HTTP Client**: Axios\n\n---\n\n## 🛠️ Setup Instructions\n\n1. **Clone the repository**\n\n```bash\ngit clone https://github.com/your-username/pulse-wire.git\ncd pulse-wire\n```\n2. **Install dependencies**\n- npm install\n- Create .env file\n- VITE_GUARDIAN_API_KEY=your_guardian_api_key Or hardcode the key in your hook temporarily for testing.\n\n3. **Run the application**\n- npm run dev\n- Visit: http://localhost:5173 (or as defined by your dev server)\n\n---\n\n## 📦 Folder Structure\n\n```bash\nsrc/\n│\n├── components/       # Reusable UI components (e.g., NewsCard, SearchBar)\n├── hooks/            # Custom React hooks (e.g., useNews)\n├── pages/            # Page-level components (e.g., Home.jsx)\n├── styles/           # CSS files\n└── App.jsx           # Root component\n```\n\n---\n\n## 🔐 API Key Setup\n\nTo use **The Guardian API**:\n\n1. Sign up at [The Guardian Developer Portal](https://open-platform.theguardian.com/access/)\n2. Generate your API key\n3. Replace the key in either:\n\n   - `useNews.js` file  \n   **or**\n   - Create a `.env` file and add:\n     ```env\n     VITE_GUARDIAN_API_KEY=your_guardian_api_key\n     ```\n   - Then access it in code using:\n     ```js\n     import.meta.env.VITE_GUARDIAN_API_KEY\n     ```\n\n---\n\n## 📄 License\n\nMIT License © 2025 [Abdul Ahad](https://github.com/AbdulAHAD968)\n\n---\n\n## 🙌 Acknowledgements\n\n- [The Guardian API](https://open-platform.theguardian.com/)\n- [React](https://reactjs.org/)\n- [Axios](https://axios-http.com/)\n- [Universe IO](https://universe.io)\n- [CodePen](https://codepen.com)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdulahad968%2Fpulse-wire","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabdulahad968%2Fpulse-wire","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdulahad968%2Fpulse-wire/lists"}