Alleys

# Build a website in the "Alleys" style

You are building a production-ready website. Follow the design system below exactly and adapt the content to the project. The design comes from the Qalib library (design No. 060).

## 1. The project

- Name: [fill in]
- Type of site: [fill in]
- What it does: [fill in]
- Languages: Arabic and English: Arabic first (RTL) and a full English version (LTR) with a language switch
- Pages: One page with sections and anchor links
- Contact details: [fill in]
- Assets: No photos yet: use suitable placeholders and mark each one TODO for replacement.

## 2. Visual reference

- Live demo (Arabic): https://qalib.omardeek.tech/demos/alleys/ar.html
- Live demo (English): https://qalib.omardeek.tech/demos/alleys/en.html

Each demo is one HTML file with all its CSS in a <style> tag. Download the raw file (for example `curl -s <url>`), not a summary of it, and treat its CSS as the source of truth for spacing, sizes and effects. The demo's business and text are fictional: never copy them.

## 3. Design DNA: Heritage

From Arab architecture and crafts: geometric stars, arches and mashrabiya, Palestinian cross-stitch, and true Arabic scripts (Kufi, Ruqaa, Naskh) in earth, clay and indigo tones.

- **Typography:** An authentic Arabic display script (Ruqaa, Kufi or a simplified Thuluth), clear Naskh for text, and a classical Latin capital face to pair.
- **Colour:** Earth tones (sand, clay, olive) with embroidery red, indigo or zellige turquoise, and touches of brass.
- **Layout:** Symmetrical compositions, photos inside arches, ornamental bands between sections, centred headings.
- **Shapes:** Pointed or round arches for images, eight-point stars, cross-stitch borders, ornamented corners.
- **Imagery:** Old architecture, doors and alleys, handicrafts, traditional food in warm light.
- **Motion:** Calm: soft reveals and a very slow rotation of ornamental stars.
- **Details:** A faint geometric pattern as a background, embroidery ribbons, Arabic-Indic numerals in details where they fit.
- **Avoid:** Ornament so dense it smothers content, broken or disconnected Arabic lettering, letter-spacing Arabic.

**This design in particular:** Warm Jerusalem stone, rust and teal, a photographer of old quarters: a photo in an arch, a wall of pictures and packages in a ruled table.

## 4. Design tokens

```css
:root {
  --bg: #EFE7DA; /* page background */
  --surface: #F8F3EA; /* cards, panels, alternate sections */
  --ink: #2B2118; /* main text */
  --muted: #6E5F4E; /* secondary text */
  --accent: #8C3B1F; /* buttons, links, highlights */
  --accent2: #2E5E5A; /* second highlight */
  --line: #DCCFBC; /* rules and borders */
  --on-accent: #FFFFFF; /* text on the accent colour */
  --radius: 0px;
}
```

- Colour scheme: light
- Fonts (available on Google Fonts and fontsource; self-host them):
  - Arabic headings: Reem Kufi (400, 500, 700)
  - Arabic text: Amiri (400, 700)
  - Latin headings: Cormorant Garamond (400, 500, 600, 700)
  - Latin text: EB Garamond (400, 600)
- Type scale: h1: clamp(2.7rem, 6.2vw, 5.4rem) · h2: clamp(2rem, 4.2vw, 3.3rem) · h3: 1.25rem · text: 17px with 1.7 line height (Arabic 18px and 1.9) · max width 1200px · section spacing clamp(72px, 10vw, 136px)

## 5. Page structure

The demo shows a Photographer. Build the sections with these visual treatments, in this order:

1. **Header**: The logo centred on top with the links in a row beneath it, like a masthead; the call-to-action sits at the end.
2. **Hero**: Text on one side; a tall photo cut into an arch on the other.
3. **Gallery** «Selected»: a masonry wall of photos with mixed heights
4. **About** «About me»: Two columns: heading, paragraphs and a short signed quote; a tall photo with a smaller photo overlapping its corner.
5. **Pricing** «Packages»: a ruled table: number, title, description, and price or time
6. **Testimonials** «Kind words»: one large centred testimonial at a time, rotating every few seconds, with dots
7. **Call to action** «Let's make something beautiful»: a full-width coloured band with a heading, a line of text and a button
8. **Contact** «Contact»: Two columns: heading, text and address/phone/email with icons; a panel with opening hours and a WhatsApp button.
9. **Footer**: four columns (brand and tagline, page links, contact, social) and a bottom bar

## 6. Motion

Subtle: elements fade up about 24px as they enter, staggered by 70ms; light lifts on hover.

**Decorations in this design:**
- a faint repeating eight-point-star pattern behind alternate sections
- small ornamental dividers between sections: an eight-point star

## 7. Technical requirements

- **Stack:** Choose the stack that fits the project; prefer static HTML, CSS and JavaScript unless it needs more.
- Semantic HTML, mobile first, adapting at 360, 768, 1024 and 1440px, with no horizontal scrolling.
- Arabic: <html lang="ar" dir="rtl">, CSS logical properties (margin-inline-start, inset-inline-end…), mirrored directional icons, never letter-space or uppercase Arabic, and Arabic text at 18px or more.
- Accessibility: WCAG AA contrast, visible focus states, alt text on images, and all motion off under prefers-reduced-motion.
- Performance: self-hosted fonts with font-display: swap and only the weights and subsets in use, WebP or AVIF images with set dimensions, lazy loading below the first screen, and no heavy libraries for simple effects.
- SEO: a title and description for every page, Open Graph, a favicon, and LocalBusiness structured data where relevant.
- Buttons: WhatsApp links as https://wa.me/<number>, phone as tel:, email as mailto:.

## 8. Delivery

1. Start with the tokens and base styles, then build the sections from top to bottom.
2. Compare the result with the live demo at phone and desktop widths before you finish.
3. Finish with how to run the site and how to deploy it.

Paste it into Claude Code inside a new project folder.