Case study · Miradouro da Penha
Four rooms, the infrastructure of a hotel.
It opened in August 2026 with everything in place: a website that sells direct in three languages, an app that handles check-in, SIBA, the invoice and the tourist tax, and an AI agent that coordinates housekeeping on WhatsApp. Adapted in weeks from the base already running at Livin Stays Algarve.
The app screenshots use invented data — no real guest, booking or amount. The website screenshots are the public pages.
- Client
- Miradouro da Penha, a four-room guesthouse in Faro
- Used by
- Guests, management and the housekeeping team
- In production
- Since August 2026
- Stack
- Astro · React · TypeScript · Supabase
-
4
rooms on a top floor with a terrace over Faro
-
3
website languages — Portuguese, English and Spanish
-
64
bookings since opening
-
1 000+
guest messages logged
-
400+
automated tests
The house’s real figures in October 2026.
Context
Where it started
Miradouro da Penha is four rooms on the top floor of a building in Penha, above Faro, with a panoramic terrace and a shared kitchen. A small house with a small team — and the same obligations as a hotel: a SIBA report for every foreign guest, the municipal tourist tax, certified invoicing.
Instead of starting from scratch, we adapted the website and the app already running at Livin Stays Algarve: the same base, tuned for a four-room house. It opened in August 2026 with direct bookings, online check-in and automatic SIBA from day one.
Website
A website that sells direct.
Rooms with real photos, availability and prices read from the channel manager and payment on the website itself: a 20% deposit with the rest charged automatically on arrival day, or everything at once by Multibanco or MB WAY.
- Portuguese, English and Spanish, with pages for the house, the rooms, the shared spaces and the location
- Promo codes and the tourist tax as its own line
- A page where guests manage the booking and cancel with a refund
- A house guide in five languages
- The paid booking reaches the channel manager and the app on its own
Operations app
The house’s day, in one app.
MP-PRO shows arrivals, departures and who is in house, what needs attention and the room board. Every booking has a sheet with its guests, check-in, payments, messages and history.
- Booking.com and Airbnb bookings synced every hour
- Guest requests — early check-in, late check-out — with the decision recorded
- Repairs and access instructions per room
- Works on the phone, installable as an app
Guests and compliance
From online check-in to SIBA, without paper.
Guests complete online check-in in Portuguese, English or Spanish; SIBA reports are filed through the web service twice a day; door codes are pushed to each room’s smart lock. After the stay, the feedback request offers a 10% code to come back.
- Check-in form with each guest’s details and document
- SIBA board: arrivals of the next 7 days, to file and overdue
- Monthly Nuki and TTLock lock codes managed in the app
- Feedback with per-category scores and come-back codes
Finance
Invoice, commission and tourist tax without manual sums.
The stay’s invoice is issued in CloudInvoice on arrival day, with the tourist tax on its own line. At the end of the month the app prepares the municipal tax declaration for Faro City Council and the commission statement.
- Invoices, receipts, credit notes, deposits and extras
- Audit: stays without an invoice and failed issues
- Tourist tax declaration with the 7-night cap and exemptions
- Commission statement as PDF
AI agent
Ana coordinates housekeeping on WhatsApp.
Ana is the team’s AI agent, on our own server. She works in the housekeeping WhatsApp group with the app’s data: she asks whether a room is ready, sends the cleaning plan and the booking map, and sends the manager the day’s report at 20:00. She does not talk to guests or send door codes.
- “Room ready?” polls before each arrival
- Cleaning plan, linen changes and booking map in the group
- Team requests to approve and lock battery alerts
- Her own limited database access; every write is audited
Integrations
Connected to the channels, the payments and the doors.
-
Avaibook
Channel manager: Booking.com and Airbnb every hour; website bookings go in on their own.
-
Stripe
A 20% deposit and the balance charged on arrival day, Multibanco, MB WAY and refunds.
-
CloudInvoice
Certified invoices, receipts and credit notes.
-
SIBA
Guest registration reports filed through the web service, twice a day.
-
Nuki e TTLock
Monthly lock codes for each room and battery alerts.
-
E-mail transacional
Confirmation, online check-in, instructions and feedback in three languages.
-
WhatsApp
Ana, the housekeeping team’s AI agent.
-
Supabase
Postgres with 51 tables and 114 security policies, server functions and 7 scheduled jobs.
Engineering
How it is built
- 01
Astro website with static pages and a Node server for bookings and payments; React and TypeScript app installable as a PWA
- 02
The same base as Livin Stays Algarve, adapted to a four-room house — with shared rules checked by tests in both projects
- 03
Row-level security on every table; the agent has its own role and every write she makes is logged
- 04
69 versioned migrations and more than 400 automated tests
- 05
Guest contact details anonymised automatically after the stay
Outcome
A four-room guesthouse opened with direct bookings, online check-in and automatic SIBA from day one.
Next step
A small house with a hotel’s obligations?
A 30-minute conversation is enough for us to say what to automate first, what it costs and when it is ready.