A beautiful desktop & web app that displays random pins from any public Pinterest board. Paste a board URL, click "Inspire Me!", and discover creative content.
- 📌 Random Pin Discovery - Get inspired with random pins from any public board
- 🎨 Beautiful UI - Modern glassmorphism design with animated gradients
- 🖥️ Native Mac App - Built with Tauri for a lightweight desktop experience
- 🌐 Web App - Also works in any modern browser
- ⚡ Smart Loading - Prefetches board data while you type
- 🎭 Cute Animations - Delightful loading animations (floating pins, bouncing hearts, spinning sparkles)
- 🔒 Privacy-First - No API keys needed, uses public RSS feeds
Visit the live app at: https://houke.github.io/pinspiration/
# Clone or navigate to the project
cd pinspiration
# Install dependencies
npm install# Run in browser (web dev mode)
npm run dev
# Run as desktop app (Tauri dev mode)
npm run tauri:dev# Build web assets only
npm run build
# Build Mac desktop app
npm run tauri:buildThe built .app will be in src-tauri/target/release/bundle/macos/.
- Find a public Pinterest board you like
- Copy the board URL (e.g.,
https://www.pinterest.com/pinterest/pin-pets/) - Paste it into the input field
- Click Inspire Me! ✨
- View a random pin with its image, title, and details
- Click Try Another for more inspiration
| Technology | Purpose |
|---|---|
| React 19 | UI Framework |
| TypeScript | Type Safety |
| Vite | Build Tool |
| Tauri 2.0 | Desktop Wrapper |
| Vanilla CSS | Styling |
The app fetches pins using a smart hybrid strategy:
- RSS Feeds - Tries Pinterest's public RSS feeds first for speed.
- Deep Fetching - Fallback to intelligent HTML scraping via robust CORS proxies to find more pins when RSS fails or limits results.
This approach:
- ✅ Requires no API key
- ✅ Works with any public board
- ✅ Respects Pinterest's terms of service
Smart Loading: The app prefetches board data while you type and caches results for 5 minutes for instant subsequent loads.
| Command | Description |
|---|---|
npm run dev |
Start Vite dev server |
npm run build |
Build web assets |
npm run preview |
Preview production build |
npm run lint |
Run ESLint |
npm run tauri:dev |
Run Tauri desktop app in dev mode |
npm run tauri:build |
Build production Mac app |
This project auto-deploys to GitHub Pages on every push to main.
To set up GitHub Pages:
- Go to your repo Settings → Pages
- Set Source to "GitHub Actions"
- Push to
mainbranch
MIT
Made with ❤️ and ✨ for my wife.