Add README with project overview and quick start guide
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
51
README.md
Normal file
51
README.md
Normal file
@@ -0,0 +1,51 @@
|
|||||||
|
# Price Hunter
|
||||||
|
|
||||||
|
A self-hosted price comparison engine. Search across multiple online stores simultaneously, compare prices, and find the cheapest option — all from a single, clean interface.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- **Unified search** — One search bar, all your stores, results sorted by price
|
||||||
|
- **Store management** — Add stores with CSS selector configs, organize by category
|
||||||
|
- **Store testing** — Per-store test pages to verify scraping before going live
|
||||||
|
- **Categories & groups** — Filter searches by category or custom store groups
|
||||||
|
- **Scrape health** — Monitor success rates, response times, and error logs per store
|
||||||
|
- **Self-hosted** — All data stays local. No ads, no tracking, no external dependencies.
|
||||||
|
|
||||||
|
## Quick Start
|
||||||
|
|
||||||
|
### Development
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install
|
||||||
|
cd src/client && npm install && cd ../..
|
||||||
|
npm run dev
|
||||||
|
```
|
||||||
|
|
||||||
|
Open http://localhost:5173 (frontend) — API runs on http://localhost:3000.
|
||||||
|
|
||||||
|
### Docker
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker compose up
|
||||||
|
```
|
||||||
|
|
||||||
|
Open http://localhost:3000.
|
||||||
|
|
||||||
|
## Tech Stack
|
||||||
|
|
||||||
|
- **Backend:** Node.js, Fastify, sql.js (SQLite)
|
||||||
|
- **Frontend:** SvelteKit, Tailwind CSS
|
||||||
|
- **Scraping:** Cheerio (CSS selectors)
|
||||||
|
- **Deployment:** Docker
|
||||||
|
|
||||||
|
## Adding a Store
|
||||||
|
|
||||||
|
1. Go to **Stores** > **Add Store**
|
||||||
|
2. Fill in the store name, base URL, and search URL (use `{query}` as the search term placeholder)
|
||||||
|
3. Define CSS selectors for: product container, name, price, link, and optionally image
|
||||||
|
4. Save and use the **Test** page to verify results
|
||||||
|
5. Enable the store to include it in searches
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
MIT
|
||||||
Reference in New Issue
Block a user