This Privacy Policy explains how mealheiro ("we", "us") processes your personal data when you use the mealheiro application (the "Service"). We process personal data in accordance with the EU General Data Protection Regulation ("GDPR").
1. Controller and contact
The data controller is the mealheiro project operator. Contact: support@mealheiro.app.
2. What data we collect
Account data
- Email address, first name and last name (provided at sign-up).
- Your password, stored only as a cryptographic hash — we never store or see your plain-text password.
- The version and timestamp of the Terms of Service and Privacy Policy you accepted at registration.
Financial records you enter
- Accounts, transactions (title, description, value, type, date), categories and labels that you create manually in the Service.
- This data is entered by you; the Service does not connect to your bank or any third-party financial institution.
Technical data
- An authentication cookie (
accessToken) and a session-scoped browser storage entry holding your profile name and email. Both are strictly necessary to operate the Service. - Server logs, traces and metrics needed to run and secure the Service (which may include IP addresses in transport logs).
- Optional, consent-based front-end performance monitoring (see section 5).
- Optional push subscription data, only if you turn notifications on in Settings: the push service endpoint URL your browser provides, its encryption keys, and your time zone and language (so reminders arrive on the right day, in your language).
3. Purposes and legal bases
- Providing the Service (account management, storing and displaying your financial records): performance of a contract, Art. 6(1)(b) GDPR.
- Security and abuse prevention (server logs, authentication): legitimate interest, Art. 6(1)(f) GDPR.
- Proof of consent (accepted terms version and date): legal obligation / accountability, Art. 6(1)(c) and 7(1) GDPR.
- Front-end performance monitoring: consent, Art. 6(1)(a) GDPR — only active if you opt in, and you can withdraw at any time in Settings.
- Due-transaction reminders (push notifications when a recurring transaction is due): consent, Art. 6(1)(a) GDPR — only active if you turn notifications on, and you can withdraw at any time with the notifications toggle in Settings.
We do not sell your personal data, we do not use it for advertising, and we do not use it for automated decision-making or profiling that produces legal effects.
4. Cookies and local storage
accessToken— httpOnly cookie that keeps you signed in. Strictly necessary; expires with your session token.NEXT_LOCALE— cookie remembering your language choice. Strictly necessary for the requested functionality.NEXT_TIMEZONE— cookie remembering your browser's time zone so dates are shown in your local time. Strictly necessary for the requested functionality; expires after one year.sidebar_state— cookie remembering whether you collapsed the side menu; expires after one week.user-storage— sessionStorage entry with your name and email for display; cleared when the browser session ends or you log out.tz-sync-attempted— sessionStorage entry recording that your time zone was already synced this session; cleared when the browser session ends.telemetry-consent— localStorage entry remembering your monitoring consent choice.theme— localStorage entry remembering your light/dark theme choice.color-theme— localStorage entry remembering your accent colour choice.recurring-prompted-on— localStorage entry remembering the day you were last reminded of due recurring transactions, so the reminder shows at most once a day; removed when you log out or delete your account, and again whenever someone signs in on this device.install-hint-dismissed— localStorage entry remembering that you dismissed the "Install the app" hint.dashboard-period— localStorage entry remembering the period you last picked on the home dashboard.last-used-account— localStorage entry remembering the internal id of the account you last added a transaction to, so the next one starts there; removed when you log out or delete your account, and again whenever someone signs in on this device.last-activity— localStorage entry with the time of your last click or keystroke in the app, shared by its open tabs, so we can sign you out after 15 minutes of inactivity.idle-sign-out— localStorage entry with the time you were last signed out for inactivity, so the sign-in page can tell you why.changelog-seen— localStorage entry remembering the newest blog post you have seen, so new ones are marked.mealheiro-import-report— localStorage entry written while a CSV import runs and removed when it completes; it remains only if the import was interrupted or its undo didn't finish, so you can retry or undo it after signing back in. It holds internal ids, file line numbers, error codes and counts, plus a fingerprint (not the address) of your email so only you are offered the undo; no amounts, descriptions, payees or other transaction details. Deleted when you dismiss it, log out or delete your account, or on your next visit once it is more than 7 days old.com.grafana.faro.session— sessionStorage entry with a random monitoring session id and its timestamps; only set if you opt in to performance monitoring (section 5).mealheiro-offline-v1— browser cache holding only the static "You're offline" page; no personal or financial data is cached.
Because the strictly necessary items are exempt from consent under the ePrivacy rules, the only consent we ask for is the optional performance monitoring below.
5. Performance monitoring (optional)
If you opt in, we use the following tools to find bugs and slowness:
- Grafana Faro real-user monitoring collects error reports, page-load timings and request traces from your browser. Every address it records is stripped of its query string, so search text and filters are never sent.
- Vercel Web Analytics counts anonymous page views: the page path (without the query string), referrer, country, and device, operating system and browser type.
- Vercel Speed Insights measures Core Web Vitals (how fast pages load and respond) per page path, again without the query string.
Vercel Web Analytics and Speed Insights set no cookies; visitors are counted with a hash that resets daily and cannot identify you. The data is pseudonymous session telemetry; we do not use it to build user profiles. You can grant or withdraw this consent at any time on the Settings page — withdrawing stops collection from your next page load.
6. Recipients and processors
We use the following providers to run the Service, acting as processors under Art. 28 GDPR data-processing agreements:
- Hetzner Online GmbH (Germany) — hosts the backend API and the PostgreSQL database where your account and financial records are stored, in its Helsinki (Finland) datacentre. Your data stays in the EU.
- Vercel Inc. (USA) — hosts the web front-end that serves the application to your browser and, only if you opt in, receives the Web Analytics and Speed Insights data described in section 5.
- Cloudflare, Inc. (USA) — provides DNS and acts as a network proxy in front of the Service; it sees IP addresses and traffic metadata in transit.
- Grafana Labs (USA) — stores the logs and traces of our web server and our API for all users: internal ids, routes, error codes and timings (see section 7). Only if you opt in, it also receives the Grafana Faro telemetry from your browser described in section 5. This data is stored in the EU, in Grafana Cloud's Ireland region.
If you turn notifications on, reminders are delivered through the push service your browser uses: Google (Firebase Cloud Messaging) for Chrome, Edge and other Chromium browsers, Apple (Apple Push Notification service) for Safari and the installed app on iPhone and iPad, or Mozilla (autopush) for Firefox. They receive only an encrypted message saying that a recurring transaction is due — never amounts, titles or descriptions — and the push service endpoint they assigned to your browser.
We disclose personal data to public authorities only where legally required.
Where a processor is located outside the EU/EEA, transfers rely on an adequacy decision (such as the EU–US Data Privacy Framework) or the European Commission's Standard Contractual Clauses.
7. Retention and deletion
- Account and financial data: kept while your account exists. When you delete your account in Settings, your profile and all your accounts, transactions, categories, labels, recurring transactions and push subscriptions are erased from our live database immediately and permanently, all at once (backups: see below). We keep no archive, no "deleted" copy and no anonymised version. We keep only your account's internal id and the deletion time, for 35 days (a short period after the 30-day backup window), so the deletion can be repeated if a backup is ever restored. Deleting a single item erases it the same way. Download your data export first if you want a copy.
- Push subscription data: kept until you turn notifications off, sign out on that device, the push service reports the subscription expired, the device hasn't checked in for 90 days, or you delete your account. The markers recording which reminders were already sent are deleted 3 days after the reminder's date.
- Operational logs and traces (including opt-in performance monitoring): kept for up to 30 days, then deleted. They record technical details such as internal ids, pages, error codes and timings, never the titles, descriptions or amounts of your transactions. Aggregated, non-identifying performance metrics are kept for up to 13 months. Anonymous page-view counts and Web Vitals (section 5) are kept according to our analytics provider's retention, currently up to 12 months.
- Backups: deleted data leaves our database backups within 30 days at the latest. If we ever have to restore a backup, we erase again every account that was deleted after that backup was taken.
8. Your rights
Under the GDPR you have the right to:
- access the personal data we hold about you (Art. 15);
- rectify inaccurate data (Art. 16);
- erasure — delete your account and data yourself in Settings, at any time (Art. 17);
- restrict or object to processing (Arts. 18, 21);
- data portability — download a machine-readable JSON export of all your data from Settings (Art. 20);
- withdraw any consent at any time, without affecting prior processing (Art. 7(3));
- lodge a complaint with a supervisory authority — in Portugal, the CNPD (Comissão Nacional de Proteção de Dados, cnpd.pt), or the authority of your country of residence (Art. 77).
For anything you cannot do self-service, contact support@mealheiro.app; we respond within one month.
9. Security
We protect your data with TLS encryption in transit; passwords stored only as salted hashes; per-user data isolation enforced on every request; a sign-in token kept in an httpOnly cookie that scripts on the page cannot read; and access controls on production systems. Your account and financial records are stored in the European Union. No system is perfectly secure; if a breach is likely to result in a risk to you, we will notify you and the supervisory authority as required by Arts. 33–34 GDPR.
10. Children
The Service is not directed at children and may not be used by anyone under 16 years of age. We do not knowingly collect data from children.
11. Changes to this policy
The version and effective date are shown at the top of this page. For material changes we will notify you in the application or by email. See also our Terms of Service.