Skip to main content

​
Welcome to Adosa Real Estate

Adosa Real Estate is a premium, luxury-focused real estate website built with cutting-edge web technologies. This documentation will help you understand, customize, and extend the platform.

Quick Start

Get up and running in minutes with our quickstart guide

Components

Explore the reusable UI components

API Integration

Learn about the eGO Real Estate API integration

Deployment

Deploy your site to production

​
What is Adosa Real Estate?

Adosa is a modern, static website built specifically for luxury real estate showcasing. The platform emphasizes visual impact, smooth animations, and an exceptional user experience that matches the premium nature of the properties being displayed.

​
Key Features

Astro 5 Static Generation

Built on Astro 5 for optimal performance and SEO

Premium Animations

GSAP animations with ScrollTrigger and Lenis smooth scrolling

Multi-language Support

Bilingual support (Spanish/English) with i18n routing

API Integration

Real-time property data from eGO Real Estate CRM

Interactive Maps

Leaflet maps for property locations

Responsive Design

Premium minimalist aesthetic across all devices

Automated Deployment

GitHub Actions for continuous deployment

Lead Management

Contact forms with PHP proxy backend

​
Technology Stack

The Adosa Real Estate platform is built with a carefully selected technology stack designed for performance, developer experience, and visual excellence:
  • Core Framework: Astro 5 for static site generation
  • Styling: Vanilla CSS with CSS Variables for theming
  • Animations: GSAP with Power3 easing and ScrollTrigger
  • Smooth Scroll: Lenis for premium scroll experience
  • Maps: Leaflet for interactive property locations
  • Type Safety: TypeScript for robust code
  • Backend Integration: eGO Real Estate API with PHP proxy

​
Project Philosophy

The Adosa Real Estate website prioritizes:
  1. Visual Impact: Every element is designed to impress and convey luxury
  2. Performance: Static generation ensures fast load times and excellent SEO
  3. User Experience: Smooth animations and intuitive navigation
  4. Maintainability: Clean code structure with reusable components
  5. Scalability: Easy to add new properties and features

​
Architecture Overview

src/
├── components/       # Reusable UI components
├── layouts/          # Page layout templates
├── pages/            # Route definitions with i18n support
├── styles/           # Global CSS, theme, and animations
├── utils/            # Helper functions and animation utilities
├── data/             # Property data types and interfaces
├── services/         # API integration services
└── i18n/             # Internationalization utilities
All source code is available in the ~/workspace/source/ directory. The project follows Astro’s file-based routing conventions.

​
Design Principles

The Adosa website follows these core design principles:
  • Minimalism: Clean, uncluttered layouts that let properties shine
  • Premium Feel: Sophisticated typography, subtle animations, smooth transitions
  • Dark Theme: Elegant dark backgrounds with gold accents
  • Fluid Typography: clamp() based responsive text sizing
  • Consistent Spacing: Standardized padding and margins via CSS utilities

​
Next Steps

1

Install Dependencies

Follow the installation guide to set up your development environment
2

Run Locally

Start the development server and explore the codebase
3

Understand Core Concepts

Learn about architecture, design system, and i18n
4

Explore Components

Review the component library to understand available UI elements

​
Getting Help

If you need assistance:
This documentation covers both usage and development of the Adosa Real Estate platform. Navigate using the sidebar to find specific topics.

Build docs developers (and LLMs) love

Get started for freeTalk to us