Pash is a minimalist personal dashboard for your browser. It integrates Google Calendar, Google Tasks, a local notes app with rich text editing, a weather widget (optional), and a clock. Everything is handled client-side; no server or backend is required. Pash is also a Progressive Web App (PWA) that can be installed on your desktop or mobile device.
- ★ View your Google Calendar events
- ★ Manage your Google Tasks
- ★ Create and edit rich-text notes (powered by Quill.js)
- ★ Display current weather (requires OpenWeatherMap API key)
- ★ Live clock (uses system timezone automatically)
- ★ Dark mode and light mode themes
- ★ Persistent settings saved in your browser (localStorage)
- ★ No backend required
- ★ PWA support - install on desktop or mobile
- ★ Rearrangeable sections - drag and drop to customize layout
Stretch goal: an Electron-based app version in the future.
-
Clone this repository
git clone https://github.com/yourusername/pash.git
-
Host the files
- You can simply open
index.htmlin your browser for local use. - For remote hosting, upload to any web server (even basic FTP hosting works).
- You can simply open
-
Set up API credentials
- Go to Google Cloud Console:
- Create OAuth 2.0 Client ID credentials (type: Web Application)
- Authorise JavaScript origins and redirect URIs (e.g.,
https://yourdomain.com/pash/). - Important: Redirect URIs must exactly match your deployed URL, including trailing slashes.
- Enable the Google Calendar API and Google Tasks API.
- (Optional) Sign up for OpenWeatherMap to get a free weather API key.
- Go to Google Cloud Console:
-
Configure settings
- Open the ⚙️ Settings panel on your dashboard.
- Enter your Google API Client ID, Google API Key, and OpenWeatherMap API Key if desired.
- Customise title, theme, clock format, and other options.
-
Done!
Pash can be installed as a standalone app on most devices and platforms:
- Visit your Pash installation in the browser
- Look for the install icon (⊕) in the address bar or menu
- Click "Install" when prompted
- Visit your Pash installation in Chrome
- Tap the menu (⋮) button
- Select "Add to Home screen"
- Visit your Pash installation in Safari
- Tap the Share (↑) button
- Select "Add to Home Screen"
Benefits of using Pash as a PWA:
- Runs in its own window without browser UI
- Adds a desktop/home screen icon for quick access
- Faster loading through caching
- Basic offline capabilities for the UI components
- This app relies entirely on client-side execution. Your data remains on your device.
- No personal or calendar/task data is ever sent to any third-party servers.
- Pop-up blockers may interfere with the Google sign-in process.
- Weather functionality is optional. If you do not configure a weather API key, the widget will not display live data.
- Future development may include an optional Electron desktop version.
Pash is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) license.
- You are free to share and adapt the code.
- Attribution is required (credit the original author).
- Non-commercial use only. Commercial use is strictly prohibited without explicit permission.
For full details, see the official license description.
- Electron integration
Contributions are welcome for non-commercial improvements! Submit a pull request or open an issue if you have suggestions or bugs to report.
- Google Identity Services
- Google Calendar API
- Google Tasks API
- OpenWeatherMap API
- Quill.js for rich text editing
- Font Awesome for icons
- Sortable.js for drag-and-drop functionality
- Service Workers API for PWA offline support
- Web App Manifest for PWA installability
Dashboard built for personal use and learning purposes. Use responsibly.