{"_id":"@anouar258/google-reviews-widget","name":"@anouar258/google-reviews-widget","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@anouar258/google-reviews-widget","version":"1.0.0","description":"A free, open-source Google Reviews widget. Zero monthly fees, SEO-friendly, and supports Grid/Carousel layouts + Multi-language.","type":"module","author":{"name":"AnouarLab","url":"https://anouarlab.fr"},"license":"MIT","keywords":["google-reviews","web-component","widget","seo","reviews"],"main":"./dist/widget.es.js","types":"./dist/widget.d.ts","scripts":{"dev":"vite","build":"tsc && vite build","preview":"vite preview","fetch-reviews":"node scripts/fetch-reviews.js"},"devDependencies":{"@types/node":"^22.13.1","typescript":"^5.9.3","vite":"^5.4.21"},"gitHead":"f52f12023416b214fb077ad2813b8c6842497dfd","_id":"@anouar258/google-reviews-widget@1.0.0","_nodeVersion":"25.2.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-fm4SQWVBGLN4weZjEMJuhIDOYEhgNTNLu1si2OV7rJGFCNtU2fiviT5NEUfZiRx0NLUrZqmCR0tOYn3OPLkkbg==","shasum":"b28d523ac5a92f8707ceae203e6f8ac593c7332c","tarball":"https://registry.npmjs.org/@anouar258/google-reviews-widget/-/google-reviews-widget-1.0.0.tgz","fileCount":5,"unpackedSize":21492,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDiKKjmvyVzpq1WgQ0/dEjQqu7XCmpgogDajCobuXnbwwIgLf2PdppN9ovAm2X/OZhM5T6FtvrIzl79zYDFTFFF56M="}]},"_npmUser":{"name":"anouar258","email":"sbiaanouar@gmail.com"},"directories":{},"maintainers":[{"name":"anouar258","email":"sbiaanouar@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/google-reviews-widget_1.0.0_1770843938632_0.36340216871503794"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-11T21:05:38.534Z","1.0.0":"2026-02-11T21:05:38.767Z","modified":"2026-02-11T21:05:38.980Z"},"maintainers":[{"name":"anouar258","email":"sbiaanouar@gmail.com"}],"description":"A free, open-source Google Reviews widget. Zero monthly fees, SEO-friendly, and supports Grid/Carousel layouts + Multi-language.","keywords":["google-reviews","web-component","widget","seo","reviews"],"author":{"name":"AnouarLab","url":"https://anouarlab.fr"},"license":"MIT","readme":"# Universal Google Reviews Widget (Free & Open Source)\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Maintained by AnouarLab](https://img.shields.io/badge/Maintained%20by-AnouarLab.fr-blue)](https://anouarlab.fr)\n\nA zero-cost, high-performance, and privacy-friendly alternative to paid Google Reviews widgets (like Elfsight).  \nBuilt for developers who want full control, **no monthly fees**, and zero impact on their site's initial load time.\n\n**Brought to you by [AnouarLab.fr | SEO and CRO consulting](https://anouarlab.fr).**\n\n![Grid Layout Screenshot](docs/screenshots/grid-layout.png)\n\n## 🚀 Features\n\n-   **💸 100% Free**: Uses your own Google API Key (within the free tier) + GitHub Actions for caching.\n-   **⚡ Universal**: Works with React, Vue, Astro, WordPress, Shopify, or plain HTML.\n-   **🎨 Customizable**: Native \"Grid\" and \"Carousel\" layouts. Supports Dark Mode.\n-   **🔍 S.E.O. Ready**: Automatically injects `LocalBusiness` Schema.org JSON-LD for rich snippets.\n-   **📱 Responsive**: Mobile-first design with masonry grid layout.\n-   **🌍 Multi-Language**: Built-in support for 12+ languages (EN, FR, ES, DE, IT, JP, etc.).\n-   **✨ Premium Feel**: Staggered fade-in animations and \"Read More\" truncation for long reviews.\n\n## 📚 Documentation\n\nDetailed documentation is available in the `docs/` directory:\n\n-   [**📦 Installation Guide**](docs/INSTALLATION.md): Step-by-step setup (Fork, Secrets, Embed).\n-   [**⚙️ Configuration**](docs/CONFIGURATION.md): API reference for attributes (`src`, `theme`, `layout`).\n-   [**🧠 Advanced Usage**](docs/ADVANCED.md): Custom CSS styling, manual JSON hosting, and troubleshooting.\n\n## 🛠 How It Works\n\nUnlike other widgets that hit the Google API on every page load (costing money and slowing down your site), this solution uses a **Static Data Strategy**:\n\n1.  **The Backend (GitHub Actions)**: A scheduled workflow runs daily, fetches top reviews from Google, and saves them to a static `reviews.json` file in your repository.\n2.  **The Frontend (Web Component)**: A lightweight custom element `<google-reviews-widget>` fetches that static JSON file and renders it. **Zero API calls from your visitors' browsers.**\n\n## 🏗 Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Start local dev server & playground\nnpm run dev\n\n# Build for production\nnpm run build\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## 📄 License\n\nMIT © [AnouarLab.fr](https://anouarlab.fr)\n","readmeFilename":"README.md","_rev":"1-d560d45fbd62a4e2e019e7337cddad48"}