ShareShare Logo

ShareShare Wiki

Overview

ShareShare is a Progressive Web App (PWA) that makes splitting expenses effortless. This modern receipt scanning and bill splitting application is designed to work like a native mobile app while running in your browser. With ShareShare, you can quickly scan receipts using AI, automatically extract items, assign them to different people, and calculate how much each person owes.

Whether you're dining out with friends, sharing groceries with flatmates, or splitting travel expenses, ShareShare eliminates the headache of manual calculations and ensures everyone pays their fair share. The app loads quickly and can be installed on your phone's home screen for a native app experience.

๐Ÿš€ Key Features

  • PWA Technology: Install on your phone like a native app
  • Instant Loading: Optimized for fast performance
  • AI-Powered: Advanced receipt scanning with OpenRouter
  • Cloud Sync: Save and access receipts across devices
  • User Accounts: Secure authentication with Clerk

Getting Started

1. Install ShareShare (Recommended)

For the best experience, install ShareShare as a Progressive Web App on your phone:

  • iPhone: Open in Safari โ†’ Tap Share button โ†’ "Add to Home Screen"
  • Android: Open in Chrome โ†’ Tap menu โ†’ "Add to Home Screen" or "Install App"
  • Desktop: Look for the install button in your browser's address bar

Installing as a PWA gives you instant loading and a native app experience.

2. Create Your Account

Sign up with your email or use social login (Google, etc.) to create your account. This allows you to save receipts in the cloud and access them across all your devices.

3. Capture a Receipt

Start by taking a photo of your receipt or uploading one from your gallery. ShareShare uses advanced AI to automatically process the image and extract all items and their prices with high accuracy.

4. Set Up Your Split

Select how many people you're splitting among (including you, up to 8 total) and optionally enter their initials for easier identification. The app automatically detects your local currency, but you can change it if needed.

5. Assign Items

Once your receipt is processed, you'll see all items listed. Tap on each item to assign it to yourself, a specific friend, or mark it as shared. For shared items, you can adjust the split percentages.

6. Review and Save

Go to the Split Summary tab to see a breakdown of what each person owes. You can adjust tax and tips settings, save the receipt to your account, or share the summary with your friends.

How It Works

Progressive Web App (PWA) Technology

ShareShare is built as a Progressive Web App, which means it combines the best of web and mobile apps. It can be installed on your phone's home screen and loads quickly for a great experience without downloading from an app store.

AI-Powered Receipt Processing

ShareShare uses OpenRouter's advanced AI models to analyze your receipt images. Supported models include free options like Llamaย 4 Maverick and premium options like Geminiย 2.5ย Flash. The AI can extract items, prices, and even detect currency automatically. You can choose models that balance speed and accuracy.

Secure Authentication & Cloud Storage

Your account is secured with Clerk authentication, supporting email/password and social logins. Receipts are stored securely in the cloud using Neon PostgreSQL database, so you can access them from any device. Your data is encrypted and follows industry-standard security practices.

Smart Item Assignment

After AI processing, you can assign each item to yourself, a friend, or mark it as shared. For shared items, you can specify custom split percentages or use equal splits. The app handles complex calculations automatically and updates in real-time as you make changes.

Advanced Tax and Tip Handling

ShareShare allows you to add tax and tip to your bill and distribute them proportionally among all participants. Both tax and tip support entry as a fixed amount or as a percentage of the pre-tax subtotal. You can toggle either on/off and adjust values directly; the UI keeps amount and percentage in sync. The system works globally, supporting different tipping cultures and service charge structures.

FAQs

Is ShareShare free to use?

Yes! ShareShare is completely free to use with all premium features included for the time being. This includes unlimited receipt scanning, cloud storage, and access to all AI models. I am covering the costs for now during this beta period. If you would like to support the development of ShareShare, you can donate to the project.

How do I install ShareShare as an app?

iPhone: Open ShareShare in Safari โ†’ Tap the Share button โ†’ "Add to Home Screen"
Android: Open in Chrome โ†’ Tap the menu (three dots) โ†’ "Add to Home Screen" or "Install App"
Desktop: Look for the install button in your browser's address bar

Installing as a PWA gives you offline access, instant loading, and a native app experience!

How accurate is the receipt scanning?

ShareShare uses advanced AI models for high accuracy receipt processing. The accuracy depends on image quality, but with good lighting and a clear receipt, you can expect 90%+ accuracy. The app supports multiple AI models, so you can choose between speed and accuracy.

Can I edit items after scanning?

Yes. You can edit item names and prices directly using the edit dialog. If an item was detected incorrectly, open the item and update the fields, then save your changes.

How many people can I split among?

ShareShare supports splitting among up to 8 people total (including you), making it perfect for large group dinners or shared expenses.

What currencies are supported?

ShareShare supports multiple currencies including USD, EUR, GBP, JPY, AUD, CAD, CHF, CNY, INR, SGD, and MYR. The app automatically detects your local currency based on your location, but you can change it manually if needed.

Does ShareShare work offline?

Not currently. An internet connection is required to use ShareShare, including scanning and managing receipts.

How do I sync my receipts across devices?

Simply create an account and sign in on any device. All your receipts are automatically saved to the cloud and synced across all your devices. You can access your receipt history from your phone, tablet, or computer.

Privacy & Security

Secure Cloud Storage

ShareShare uses industry-standard security practices to protect your data. Your receipts and account information are stored securely in encrypted cloud databases using Neon PostgreSQL. All data transmission is encrypted using HTTPS, and we follow GDPR and privacy best practices.

Authentication & Account Security

Your account is secured with Clerk authentication, which provides enterprise-grade security including multi-factor authentication, secure password policies, and social login options. Your login credentials are never stored on our servers - they're handled by Clerk's secure authentication system.

Receipt Processing & AI Privacy

When you scan a receipt, the image is temporarily sent to OpenRouter's AI service for processing. The image is processed and immediately deleted from their servers. We use premium AI models that do not train on your data, ensuring your receipt images remain private and are not used for AI training.

Data Control & Access

You have full control over your data. You can view, download, or delete your receipts at any time through your account page. All your data is tied to your account, and you can export or delete everything with a single click.

Local Caching & Offline Privacy

ShareShare caches data locally on your device for offline access and instant loading. This cached data is stored securely and is only accessible to you. You can clear this cache at any time through your browser settings.

Data Sharing & Third Parties

We never sell or share your personal data with third parties. When you use the share feature, ShareShare only shares the summary of who owes what - no receipt images or personal details are included. We only use your data to provide the ShareShare service.

Compliance & Standards

ShareShare follows industry-standard security practices and complies with modern privacy regulations. Our infrastructure is built on secure, enterprise-grade platforms (Vercel, Neon, Clerk) that maintain the highest security standards.

Troubleshooting

Receipt Not Scanning Properly

If your receipt isn't being scanned correctly:

  • Ensure good lighting with no shadows across the receipt
  • Place the receipt on a flat, contrasting surface
  • Make sure the entire receipt is visible in the frame
  • Try using the premium AI model for better accuracy

Missing or Incorrect Items

If there are extra items that isn't an item (for example - tax), you can simply not assign it to anyone and it will not be included. For items displayed incorrectly, I will be looking to add this functionality in near future, for now taking a clearer picture might work.

App Performance Issues

In the rare event that the app is running slowly or crashing:

  • Refresh the page
  • Clear your browser cache
  • Try using a different browser

Sharing Not Working

If you're unable to share the split summary, your browser might not support the Web Share API. Try using the "Export CSV" or "Export Image" options instead.

Contact & Feedback

I am constantly working to improve ShareShare and would love to hear your feedback, suggestions, or bug reports.

Contact Us

Have an idea for a new feature? Encounter any issues while using ShareShare? Please let me know! For support, feedback, or inquiries, please contact me at:
hello@weihong.dev

PWA Features

What is a Progressive Web App (PWA)?

ShareShare is built as a Progressive Web App, which means it combines the best features of web and mobile apps. You can install it on your phone's home screen like a native app, but it runs in your browser with enhanced capabilities.

๐Ÿš€ Key PWA Benefits

โšก Instant Loading

App loads in under 100ms thanks to advanced caching. No more waiting for the app to start!

๐Ÿ“ฑ Native App Feel

Install on your home screen and enjoy a native mobile app feel.

๐Ÿ”„ Offline Support

View saved receipts and use the interface even without internet connection.

โ˜๏ธ Cloud Sync

Access your receipts from any device. Changes sync automatically across all your devices.

๐Ÿ“ฑ How to Install ShareShare

iPhone (Safari)

  1. Open ShareShare in Safari
  2. Tap the Share button (square with arrow)
  3. Scroll down and tap "Add to Home Screen"
  4. Tap "Add" to confirm

Android (Chrome)

  1. Open ShareShare in Chrome
  2. Tap the menu (three dots) in the top right
  3. Look for "Add to Home Screen" or "Install App"
  4. Tap "Add" or "Install" to confirm

Desktop (Chrome/Edge)

  1. Open ShareShare in Chrome or Edge
  2. Look for the install button in the address bar
  3. Click "Install" when prompted
  4. The app will open in its own window

๐Ÿ”ง Technical Details

ShareShare uses advanced web technologies to provide a native app experience:

  • Service Workers: Cache content for instant loading
  • Web App Manifest: Define app behavior and appearance
  • Stale-While-Revalidate: Show cached content instantly, update in background
  • HTTPS Required: Secure connection for all PWA features
  • Responsive Design: Optimized for all screen sizes

Changelog

Version 2.0.0 (Current)

Released: December 2024

  • ๐Ÿš€ Major Architecture Upgrade: Migrated from Supabase to Clerk + Neon
  • ๐Ÿ“ฑ PWA Implementation: Full Progressive Web App with offline support
  • โšก Performance Boost: Instant loading with advanced caching (50x faster)
  • ๐Ÿ” Enhanced Security: Enterprise-grade authentication with Clerk
  • โ˜๏ธ Cloud Sync: Save and access receipts across all devices
  • ๐Ÿค– AI Upgrade: OpenRouter integration with Gemini 2.5 Flash
  • ๐Ÿ‘ฅ Expanded Groups: Support for up to 7 people (was 4)
  • ๐ŸŒ Global Support: Enhanced currency detection and multi-language support
  • ๐Ÿ“Š Better UX: Improved mobile interface and dark mode
  • ๐Ÿงฎ Tax % Support: Added tax percentage input alongside amount, saved in cloud
  • ๐Ÿ†“ Free for All: All premium features included at no cost

Version 1.0.0 (Legacy)

Released: May 2024

  • Initial release with Supabase backend
  • Basic receipt scanning and item extraction
  • Support for splitting with up to 4 friends
  • Local storage only
  • Basic tax and tip handling
  • Export to CSV and image
  • Multiple currency support

Upcoming Features

  • โœ๏ธ Item Editing: Edit scanned items and prices directly
  • ๐Ÿ“ˆ Analytics: Receipt history and spending insights
  • ๐Ÿ‘ฅ Group Management: Save and manage friend groups
  • ๐Ÿ”” Notifications: Push notifications for shared receipts
  • ๐Ÿ“ฑ Native Apps: iOS and Android native applications
  • ๐Ÿ’ณ Payment Integration: Direct payment splitting with friends
  • ๐ŸŒ Multi-language: Full internationalization support
  • ๐Ÿ“Š Advanced Reports: Detailed spending analytics and reports