Lettering

# Build a website in the "Lettering" 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. 192).

## 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/lettering/ar.html
- Live demo (English): https://qalib.omardeek.tech/demos/lettering/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: Hand-drawn

Warm and human: handwriting, wobbly drawn borders, doodles and arrows, ruled notebook paper, sticky notes and tape. For learning, crafts and small cafes.

- **Typography:** A clear handwriting face for headings, a simple comfortable text face, key words with a drawn underline.
- **Colour:** Off-white paper, dark blue or pencil-grey ink, and two marker colours (orange, green).
- **Layout:** Slightly rotated elements, sticky notes, drawn arrows linking things, a ruled or grid notebook background.
- **Shapes:** Wobbly borders (uneven border-radius), tape on photo corners, circles drawn around words.
- **Imagery:** Photos that look taped on, simple line drawings.
- **Motion:** Lightly lively: underlines that draw in, a small wiggle on hover.
- **Details:** Drawn arrows and stars, ✓ marks, handwritten side notes.
- **Avoid:** Perfect sharp edges, soft digital shadows, corporate stiffness.

**This design in particular:** Slate, chalk yellow and coral, a hand-lettering workshop: everything in chalk, a frame around the headline and work on a wall.

## 4. Design tokens

```css
:root {
  --bg: #20262B; /* page background */
  --surface: #2A3137; /* cards, panels, alternate sections */
  --ink: #F3F0E8; /* main text */
  --muted: #B4B9BC; /* secondary text */
  --accent: #F2C14E; /* buttons, links, highlights */
  --accent2: #E07A5F; /* second highlight */
  --line: #3A4248; /* rules and borders */
  --on-accent: #20262B; /* text on the accent colour */
  --radius: 0px;
}
```

- Colour scheme: dark
- Fonts (available on Google Fonts and fontsource; self-host them):
  - Arabic headings: Vibes (400)
  - Arabic text: Tajawal (400, 500, 800)
  - Latin headings: Permanent Marker (400)
  - Latin text: Nunito (400, 700, 900)
- 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 Signage & print. Build the sections with these visual treatments, in this order:

1. **Header**: A sticky bar: logo at the start, then the links, and a call-to-action button at the end; it collapses into a menu button on phones.
2. **Hero**: Headline, lead and buttons centred inside a decorative frame, with a wide photo underneath.
3. **Running text band**: a band of short words running continuously sideways
4. **About** «The workshop»: Two columns: heading, paragraphs and a short signed quote; a tall photo with a smaller photo overlapping its corner.
5. **Main offering** «Services»: a grid of cards (photo or icon, title, short text, price or note)
6. **Gallery** «Our work»: a masonry wall of photos with mixed heights
7. **Process** «How it works»: numbered steps in a row with big numbers
8. **Testimonials** «Clients»: a wall of testimonial cards in columns
9. **FAQ** «Questions»: an accordion of questions with the first one open
10. **Contact** «Contact»: A large card on a tinted background: contact details on one side, the hours and button on the other.
11. **Footer**: a single row: logo and tagline, social icons, copyright

## 6. Motion

Lively: larger 32px reveals, bouncy hovers and gently floating decorations.

**Decorations in this design:**
- a chalkboard: dashed chalk borders and chalky text

## 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.