Configuration

The configuration section lets you adapt the tool to the specifics of your property, your preferences, and the administration of the platform.

Property Configuration

Property Management

You can modify your property's basic data at any time. Remember that the Acquisition Date acts as a filter for the entire financial history.

Investment Configuration

Mortgage and Loans

If you financed the purchase, enter the monthly payment, interest rate and term. This is crucial so the profitability analysis uses the Cash Flow model (real money in hand after paying debts).

NOTE

Budget Integration: The monthly mortgage payment is automatically included in your Annual Budget and monthly base expense calculations. You don't need to add it separately as a budget item.

General Investment Data

Enter the real purchase cost and deed expenses. The application uses this data to calculate the total ROI of your asset.

Regional Tax Data

Anfitrión accounts for the tax specifics of Spain:

• Mainland and Balearics (VAT 10%)
• Canary Islands (IGIC 7%)
• Ceuta and Melilla (IPSI 10%)

Selecting your correct region is vital so the invoices you download from the application have the correct tax calculations.

Data Management

From the Data Management page (under Property in the navigation), you can manage the state of your property data:

Export Property Data

Download a complete backup of your property as a ZIP file. The archive includes a data.json with all property configuration, transactions, budgets, and campaigns, plus a receipts/ folder containing any attached receipt files. This option is only available when the property contains data.

Import Property Data

Restore a property from a previously exported ZIP file. This operation is destructive: it replaces all current property data with the contents of the import file. Receipt files in the ZIP are automatically uploaded back to Supabase Storage.

Populate Database

This option inserts dummy data (preconfigured transactions, campaigns and budgets) so you can see charts, lists and the application fully running. Note: This is a destructive operation that will wipe all existing property data before seeding the demo content.

Delete All Data

If after testing you want to leave the application clean to enter your real data, you can use this option. It permanently and cascade-deletes the current property, all its associated history (income, expenses, campaigns, configuration) and attachments stored in the Supabase Storage receipts bucket. As a safety measure, the system will require you to enter the exact property name before allowing deletion and will recommend performing an export first (offering a direct "Export Data" button within the confirmation dialog). This option is only enabled when data is present.

Application Settings

Categories and Platforms

Category Customization

Although Anfitrión offers standard categories, every business is unique. You can add, edit colors, or remove categories to fit your way of working. Categories are shared across all properties.

Platforms and Fees

Configure your sales channels here. Platforms are shared across all properties.

• Remember: Choose the fee model carefully (Deducted vs Invoiced) so the app automatically manages the creation of fee expenses.

Appearance and Style

Customize Anfitrión's visual identity. You can choose between different themes (Hogar, Anfitrión Pro, Aura) that change the color palette and typography of the entire interface to better fit your taste or brand.

Language and Regional Format

Anfitrión separates the UI language from the data formatting to accommodate different regional needs:

• UI Language: Toggled via the globe icon in the header. This changes the text in buttons, labels, and menus.
• Regional Format: Selected within the Application settings. This controls how dates, numbers, and currencies are displayed (e.g., choosing between English UK, English US, or Spanish Spain formats). This ensures that financial reports follow the conventions of your specific region.

Vision Engines for the Receipt Scanner

The receipt scanner can use different AI engines to extract data. They're configured via environment variables in your .env.local file:

Claude Vision (Anthropic)

The most accurate engine. Uses the claude-haiku-4-5 model to analyze the receipt and extract the real total amount, date and merchant name with high reliability.

• Variable: VITE_ANTHROPIC_API_KEY
• Cost: ~€0.001 per receipt. Get your key at console.anthropic.com.

OpenRouter

Alternative with a free tier that lets you use multiple vision models (Llama, Gemini, GPT-4o mini, etc.) from a single provider.

• Variable: VITE_OPENROUTER_API_KEY
• Default model: baidu/qianfan-ocr-fast:free
• Automatic fallback: nvidia/nemotron-nano-12b-v2-vl:free, if the main model fails or hits the limit.
• Change model: VITE_OPENROUTER_MODEL=google/gemini-2.5-flash
• Get your free key at openrouter.ai.

Local OCR (Tesseract.js)

Works without any API key or internet connection. It's the automatic fallback when no key is configured. Accuracy is lower, especially on receipts with poor lighting or small typography.

If you don't configure any external engine, the scanner still works with local OCR — just with lower accuracy on amount and date detection.

Administration (Admin Only)

User Management

Administrators have access to a dedicated User Management panel. From here, they can view all registered users in the system, edit their display names, and promote or demote users to/from the Administrator role. The very first user created in the application automatically receives the Administrator role.