Hebrew rtl best practices
Skill meytalp-dev/meytal-claude-code-basic/.claude/skills/hebrew-rtl-best-practices
Implement right-to-left (RTL) layouts for Hebrew web and mobile applications. Use when user asks about RTL layout, Hebrew text direction, bidirectional (bidi) text, Hebrew CSS, "right to left", or needs to build Hebrew UI. Covers CSS logical properties, Tailwind RTL, React/Vue RTL, Hebrew typography, and font selection. Do NOT use for Arabic RTL (similar but different typography) unless user explicitly asks for shared RTL patterns.From its SKILL.md
npx -y skills add meytalp-dev/meytal-claude-code-basic --skill hebrew-rtl-best-practicesAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
5.8 KB, as published. Nobody here has run it
Hebrew RTL Best Practices
Instructions
Step 1: Set Up Document Direction
Always start with the HTML attribute (not just CSS):
<html lang="he" dir="rtl">
This tells browsers, screen readers, and CSS to use RTL as the base direction.
Step 2: Use CSS Logical Properties
NEVER use physical directional properties for layout:
| Physical (avoid) | Logical (use) |
|---|---|
margin-left | margin-inline-start |
margin-right | margin-inline-end |
padding-left | padding-inline-start |
padding-right | padding-inline-end |
border-left | border-inline-start |
text-align: left | text-align: start |
text-align: right | text-align: end |
float: left | float: inline-start |
left: 10px | inset-inline-start: 10px |
This ensures the layout automatically mirrors in RTL mode.
Step 3: Handle Bidirectional Text
When mixing Hebrew and English/numbers:
/* Isolate embedded LTR content */
.ltr-content {
unicode-bidi: isolate;
direction: ltr;
}
/* For inline elements with mixed content */
.bidi-override {
unicode-bidi: bidi-override;
}
Common bidi issues:
- Phone numbers appearing reversed: Wrap in
<bdo dir="ltr"> - Punctuation at wrong end of sentence: Use
unicode-bidi: isolate - URLs/emails in Hebrew text: Wrap in
<span dir="ltr">
Step 4: Hebrew Typography
Recommended font stack:
font-family: 'Heebo', 'Assistant', 'Rubik', 'Noto Sans Hebrew', sans-serif;
Typography settings:
body[dir="rtl"] {
font-size: 16px; /* Hebrew needs slightly larger than Latin */
line-height: 1.7;
letter-spacing: normal; /* NEVER add letter-spacing for Hebrew */
word-spacing: 0.05em; /* Slight word spacing improves readability */
}
Step 5: Framework-Specific Setup
Tailwind CSS RTL:
// tailwind.config.js
module.exports = {
// Tailwind v3.1+ has built-in RTL support
// Use rtl: and ltr: variants
}
<div class="ltr:ml-4 rtl:mr-4">
<!-- Or better: use logical utilities if available -->
</div>
React with MUI:
import { createTheme, ThemeProvider } from '@mui/material/styles';
import { CacheProvider } from '@emotion/react';
import createCache from '@emotion/cache';
import rtlPlugin from 'stylis-plugin-rtl';
import { prefixer } from 'stylis';
const cacheRtl = createCache({
key: 'muirtl',
stylisPlugins: [prefixer, rtlPlugin],
});
const theme = createTheme({ direction: 'rtl' });
Next.js:
Add dir="rtl" to root layout and configure font loading for Hebrew fonts.
Step 6: Common Pitfalls to Check
- Icons with directional meaning (arrows, back buttons) -- mirror them
- Progress bars -- should fill from right to left
- Sliders/carousels -- swipe direction should reverse
- Form labels -- should be right-aligned
- Breadcrumbs -- separator direction should reverse
- Tables -- header alignment and cell alignment
- Charts -- x-axis may need to reverse for Hebrew readers
Examples
Example 1: Convert LTR Component to RTL
User says: "Make this card component work in Hebrew" Result: Replace all physical CSS properties with logical equivalents, add dir="rtl", adjust font stack.
Example 2: Bidi Text Issue
User says: "Numbers are showing backwards in my Hebrew text" Result: Wrap numeric content in a span with dir="ltr" and unicode-bidi: isolate.
Bundled Resources
References
references/css-logical-properties.md— Complete physical-to-logical CSS property mapping table (margin, padding, border, positioning, text alignment, sizing) plus Hebrew font stack recommendations for sans-serif, serif, and monospace. Consult when converting any LTR stylesheet to RTL-compatible logical properties or choosing Hebrew web fonts.
Troubleshooting
Error: "Text alignment looks wrong"
Cause: Using text-align: left instead of text-align: start
Solution: Replace all left/right in text-align with start/end.
Error: "Layout not mirroring"
Cause: Using physical margin/padding instead of logical properties
Solution: Replace all margin-left/margin-right with margin-inline-start/margin-inline-end.