Your European Home Finder

A modern property search aggregator that searches across multiple European real estate portals in real-time. Built with GraphQL, Svelte, and a thin client architecture.

"Tadaima" (ただいま) is Japanese for "I'm home" - the perfect name for a service that helps you find your next home across Europe.

• 🌍 Multi-country search - Search properties across 30+ European countries
• ⚡ Real-time results - Live data from multiple property portals
• 🎯 Smart aggregation - Deduplicates and normalizes results
• 🚀 Fast & modern - Built with GraphQL and Svelte
• 📱 Responsive design - Works on all devices

• ImmoScout24 (Germany) 🇩🇪

• Idealista (Spain, Italy, Portugal) 🇪🇸🇮🇹🇵🇹
• Daft (Ireland) 🇮🇪
• FINN.no (Norway) 🇳🇴
• Hemnet (Sweden) 🇸🇪
• Immoweb (Belgium) 🇧🇪
• Otodom (Poland) 🇵🇱
• Ingatlan (Hungary) 🇭🇺
• Rightmove (UK), Funda (Netherlands), SeLoger (France), and more

Thin Client Approach - No data storage, real-time API aggregation:

• GraphQL Server - Aggregates multiple property APIs in parallel
• Svelte Frontend - Modern, fast, reactive UI
• TypeScript - Full type safety across the stack

• Node.js 18+
• API keys from property portals (see .env.example)

# Clone and install
npm run install:all

# Start development servers
npm run dev              # Starts GraphQL server
npm run dev:frontend     # Starts Svelte frontend (separate terminal)

# Or use Docker
npm run docker:dev

Copy .env.example to .env and add your API keys:

# Get API keys from:
IMMOSCOUT24_API_KEY=     # https://api.immobilienscout24.de/
IDEALISTA_API_KEY=       # https://developers.idealista.com/
DAFT_API_KEY=           # https://api.daft.ie/doc/v3/
# ... etc

🚨 CRITICAL: Never commit files containing real API keys, tokens, or secrets!

1. Safe to Commit:

   • .env.example - Contains placeholder values like your_api_key_here
   • .env.sandbox - Contains demo/public API endpoints only

2. NEVER Commit:

   • .env - Your personal development API keys
   • .env.local - Local environment overrides
   • .env.production - Production secrets
   • .env.test - May contain test API keys

3. Protected by .gitignore:

   # dotenv environment variables file - NEVER commit secrets!
   .env
   .env.local
   .env.development.local
   .env.test.local  
   .env.production.local
   .env.test
   
   # Allow example and sandbox files to be committed
   !.env.example
   !.env.sandbox

1. Copy template: cp .env.example .env
2. Add real API keys to your local .env file
3. Never commit your .env file
4. Update .env.example when adding new environment variables (with placeholder values)

Each workspace (frontend, graphql-server) can have its own environment files:

├── .env.example              # Root-level shared config
├── .env.sandbox             # Sandbox configuration  
├── frontend/
│   ├── .env.example         # Frontend-specific template
│   └── .env                 # Your frontend config (not committed)
├── graphql-server/
│   ├── .env.example         # Server-specific template  
│   └── .env                 # Your server config (not committed)

Visit http://localhost:4000 for the GraphQL playground.

# Search properties
query SearchProperties {
  properties(
    filters: {
      country: "DE",
      minPrice: 200000,
      maxPrice: 500000,
      propertyType: APARTMENT
    }
    page: 1, limit: 10
  ) {
    totalCount
    properties {
      id, title, price, currency
      address { city, country }
      source { name }
      url
    }
  }
}

# Get countries & API status
query Metadata {
  countries { code, name, flag }
  apiStatus { source, isOnline }
}

Visit http://localhost:5173 for the Svelte application.

npm run build           # Build all packages
npm run test           # Run all tests
npm run lint           # Lint all packages
npm run check          # TypeScript checks
npm run health         # Health check server

tadaima/
├── graphql-server/    # GraphQL API aggregator
├── frontend/          # Svelte application
├── shared/           # Shared types & config
└── docs/            # Documentation

1. Fork the repository
2. Create a feature branch
3. Add tests for new functionality
4. Ensure all tests pass
5. Submit a pull request

npm run docker:build
npm run docker:up

npm run build
npm start

See /docs for detailed API documentation and integration guides.

MIT License - see LICENSE for details.

• 📧 Issues: GitHub Issues
• 📚 Docs: Documentation

Tadaima - Find your home across Europe 🏠✨