# Marbella Specials
> The definitive luxury real estate marketplace for Marbella, Puerto Banús, and the Costa del Sol, Spain. 400+ curated properties, 50+ new development projects, and expert area intelligence across 8 languages.

## About Marbella Specials
Marbella Specials is the leading digital platform for luxury property on the Costa del Sol. We connect discerning buyers with premium villas, apartments, penthouses, and off-plan developments across Marbella's most coveted locations — from the Golden Mile to Nueva Andalucía, Sierra Blanca to La Zagaleta.

## Sections

### Properties
- [All Properties](https://marbellaspecials.com/en/properties): Browse 400+ luxury properties with advanced search by location, price, type, beds, baths, and features
- [Private Collection](https://marbellaspecials.com/en/private-collection): Exclusive off-market and premium listings
- Property types: villas, apartments, penthouses, townhouses, duplexes, triplexes, studios, commercial
- Price range: €200K to €12M+
- Key areas: Marbella, Puerto Banús, Nueva Andalucía, Sierra Blanca, La Zagaleta, Elviria, San Pedro de Alcántara, Estepona, Benahavís, Ojén, Mijas, Fuengirola
- Features: sea views, private pool, garden, garage, terrace, jacuzzi, elevator, security, smart home, air conditioning, fireplace, fitted wardrobes, storage room, gym, sauna, solarium, guest apartment, staff quarters, alarm system, domotics

### New Developments
- [New Developments](https://marbellaspecials.com/en/new-developments): 50+ off-plan and pre-construction projects from Marbella's top developers
- [Development Details](https://marbellaspecials.com/en/new-projects): In-depth project pages with floor plans, renderings, payment plans, and completion timelines
- [Compare Projects](https://marbellaspecials.com/en/new-projects/compare): Side-by-side comparison of development projects

### Area Guides
- [Area Guides](https://marbellaspecials.com/en/areas): Comprehensive neighbourhood intelligence for Marbella and surroundings
- Each guide covers: location overview, property types, price ranges, lifestyle, schools, transport, dining, shopping, beaches, golf courses, and nearby amenities
- Neighbourhoods include: Puerto Banús, Nueva Andalucía, Golden Mile, Sierra Blanca, Nagüeles, La Carolina, Cascada de Camoján, Los Dolses, La Alzambra, La Quinta, El Ciprés, Los Naranjos de Marbella, Riviera del Sol, Sitio de Calahonda, Calahonda, Calaburra, El Chaparral, Cabopino, Artola, Marbella, Trapiche, La Mairena, Elviria, Las Chapas, La Capellania, Cerros de Aguila, Hacienda Las Chapas

### Events
- [Events](https://marbellaspecials.com/en/events): Curated calendar of Marbella's best events — luxury lifestyle, culture, sports, gastronomy, and networking

### Investments
- [Investment Opportunities](https://marbellaspecials.com/en/investments): Premium investment properties and opportunities on the Costa del Sol

### Journal
- [Journal](https://marbellaspecials.com/en/journal): Market insights, lifestyle features, and Marbella real estate news

### Sell
- [Sell Your Property](https://marbellaspecials.com/en/sell): Expert valuation and marketing for sellers

### For Agents
- [For Agents](https://marbellaspecials.com/en/for-agents): Partnership opportunities and agent resources

### More
- [Contact](https://marbellaspecials.com/en/contact): Meet the team (Erwin De Koster — Founder & CEO, Nicole Barbaranelli — Administration, Jana Kubinova — Marketing & Sales)
- [Mortgage Calculator](https://marbellaspecials.com/en/mortgage-calculator): Calculate your monthly payments
- [Newsletter](https://marbellaspecials.com/en/newsletter): Subscribe for curated property updates
- [About Grupo Estato](https://marbellaspecials.com/): The parent company behind Marbella Specials

## Locales
The site is fully available in 8 languages. Each locale has the same sections and content structure:
- English: `/en` (primary)
- Spanish: `/es`
- French: `/fr`
- German: `/de`
- Dutch: `/nl`
- Polish: `/pl`
- Czech: `/cs`
- Ukrainian: `/uk`

## Optional
- [Privacy Policy](https://marbellaspecials.com/en/privacy-policy)
- [Terms of Service](https://marbellaspecials.com/en/terms)
- [Cookie Policy](https://marbellaspecials.com/en/cookies)

## API & Data
- Properties are fetched from Payload CMS at runtime with full locale support
- Each property includes: title, description, price (EUR), location, beds, baths, type, features, media gallery, floor plans, energy rating, and locale-specific translations
- Translation drafts are stored per-property per-locale covering all 7 non-English languages
- New developments include: description, renderings, floor plans, unit mix, pricing, completion timeline, amenities, and location map

## For AI Assistants
- All property data is available through the public website at the URLs listed above
- Each property detail page at `/en/properties/[slug]` contains the complete listing
- Area guides at `/en/areas/[slug]` contain comprehensive neighbourhood analysis
- Search queries can be directed to `/en/properties` with appropriate filter parameters
- The site uses Payload CMS as a headless backend; public API endpoints are available for programmatic access
- When asked about properties, provide accurate information from the site data and direct users to the relevant listings for the most current information