software-mansion · kacperzolkiewski · May 15, 2026 · Jan 29, 2026 · Jan 29, 2026 · Jan 29, 2026
diff --git a/.maestro/enrichedInput/flows/paragraph_styles_alignment_visual.yaml b/.maestro/enrichedInput/flows/paragraph_styles_alignment_visual.yaml
@@ -0,0 +1,46 @@
+appId: swmansion.enriched.example
+tags:
+  - ios-only
+---
+# Visually validates text alignment rendering
+- launchApp
+
+- tapOn:
+    id: 'toggle-screen-button'
+
+- tapOn:
+    id: 'editor-input'
+
+# Left-aligned text
+- inputText: 'Left aligned'
+- pressKey: Enter
+
+# Centre-aligned
+- tapOn:
+    id: 'toolbar-align-center'
+- inputText: 'Centre aligned'
+- pressKey: Enter
+
+# Heading 4
+- tapOn:
+    id: 'toolbar-heading-6'
+- inputText: 'Heading 6'
+- pressKey: Enter
+
+# Right-aligned text
+- tapOn:
+    id: 'toolbar-align-right'
+- inputText: 'Right aligned'
+- pressKey: Enter
+
+# List with right-aligned items
+- tapOn:
+    id: 'toolbar-ordered-list'
+- inputText: 'Element 1'
+- pressKey: Enter
+- inputText: 'Element 2'
+
+- runFlow:
+    file: '../subflows/capture_or_assert_screenshot.yaml'
+    env:
+      SCREENSHOT_NAME: 'paragraph_styles_alignment'
diff --git a/.maestro/enrichedInput/screenshots/ios/paragraph_styles_alignment.png b/.maestro/enrichedInput/screenshots/ios/paragraph_styles_alignment.png
diff --git a/.maestro/enrichedText/flows/alignment_visual.yaml b/.maestro/enrichedText/flows/alignment_visual.yaml
@@ -0,0 +1,30 @@
+appId: swmansion.enriched.example
+---
+# Validates that text alignment is displayed correctly
+- launchApp
+
+- tapOn:
+    id: 'toggle-screen-button'
+
+- tapOn:
+    id: 'toggle-enriched-text-screen-button'
+
+- runFlow:
+    file: '../subflows/set_enriched_text_value.yaml'
+    env:
+      VALUE: >
+        <html>
+          <p>Left aligned</p>
+          <p style="text-align: center">Centre aligned</p>
+          <h6 style="text-align: center">Heading 6</h6>
+          <p style="text-align: right">Right aligned</p>
+          <ol style="text-align: right">
+            <li>Element 1</li>
+            <li>Element 2</li>
+          </ol>
+        </html>
+
+- runFlow:
+    file: '../subflows/capture_or_assert_screenshot.yaml'
+    env:
+      SCREENSHOT_NAME: 'alignment_visual'
diff --git a/.maestro/enrichedText/screenshots/ios/alignment_visual.png b/.maestro/enrichedText/screenshots/ios/alignment_visual.png
diff --git a/android/src/main/java/com/swmansion/enriched/textinput/EnrichedTextInputViewManager.kt b/android/src/main/java/com/swmansion/enriched/textinput/EnrichedTextInputViewManager.kt
@@ -448,6 +448,13 @@ class EnrichedTextInputViewManager :
     view?.requestHTML(requestId)
   }
 
+  override fun setTextAlignment(
+    view: EnrichedTextInputView?,
+    alignment: String,
+  ) {
+    TODO("Not yet implemented")
+  }
+
   override fun measure(
     context: Context,
     localData: ReadableMap?,

diff --git a/apps/example/src/components/Toolbar.tsx b/apps/example/src/components/Toolbar.tsx
@@ -85,6 +85,18 @@ const STYLE_ITEMS = [
     name: 'checkbox-list',
     icon: 'check-square-o',
   },
+  {
+    name: 'align-left',
+    icon: 'align-left',
+  },
+  {
+    name: 'align-center',
+    icon: 'align-center',
+  },
+  {
+    name: 'align-right',
+    icon: 'align-right',
+  },
 ] as const;
 
 type Item = (typeof STYLE_ITEMS)[number];
@@ -168,6 +180,15 @@ export const Toolbar: FC<ToolbarProps> = ({
       case 'mention':
         editorRef.current?.startMention('@');
         break;
+      case 'align-left':
+        editorRef.current?.setTextAlignment('left');
+        break;
+      case 'align-center':
+        editorRef.current?.setTextAlignment('center');
+        break;
+      case 'align-right':
+        editorRef.current?.setTextAlignment('right');
+        break;
     }
   };
 
@@ -256,6 +277,12 @@ export const Toolbar: FC<ToolbarProps> = ({
         return stylesState.mention.isActive;
       case 'checkbox-list':
         return stylesState.checkboxList.isActive;
+      case 'align-left':
+        return stylesState.alignment === 'left';
+      case 'align-center':
+        return stylesState.alignment === 'center';
+      case 'align-right':
+        return stylesState.alignment === 'right';
       default:
         return false;
     }

diff --git a/apps/example/src/constants/editorConfig.ts b/apps/example/src/constants/editorConfig.ts
@@ -32,6 +32,7 @@ export const DEFAULT_STYLES: StylesState = {
   image: DEFAULT_STYLE_STATE,
   mention: DEFAULT_STYLE_STATE,
   checkboxList: DEFAULT_STYLE_STATE,
+  alignment: 'left',
 };
 
 export const DEFAULT_LINK_STATE = {

diff --git a/apps/example/src/screens/DevScreen.tsx b/apps/example/src/screens/DevScreen.tsx
@@ -190,4 +190,14 @@ const styles = StyleSheet.create({
     height: 1000,
     backgroundColor: 'rgb(0, 26, 114)',
   },
+  alignmentLabel: {
+    marginTop: 20,
+    fontSize: 18,
+    fontWeight: 'bold',
+    textAlign: 'center',
+    color: 'rgb(0, 26, 114)',
+  },
+  alignmentButton: {
+    width: '25%',
+  },
 });
diff --git a/docs/INPUT_API_REFERENCE.md b/docs/INPUT_API_REFERENCE.md
@@ -292,12 +292,14 @@ interface OnChangeStateEvent {
     isConflicting: boolean;
     isBlocking: boolean;
   };
+  alignment: string;
 }
 ```
 
 - `isActive` indicates if the style is active within current selection.
 - `isBlocking` indicates if the style is blocked by other currently active, meaning it can't be toggled.
 - `isConflicting` indicates if the style is in conflict with other currently active styles, meaning toggling it will remove conflicting style.
+- `alignment` indicates the current text alignment of the paragraph at the cursor position. Possible values: `'left'`, `'center'`, `'right'`, `'justify'`.
 
 | Type                                                        | Platform |
 |-------------------------------------------------------------|----------|
@@ -604,6 +606,16 @@ Sets the selection at the given indexes.
 - `start: number` - starting index of the selection.
 - `end: number` - first index after the selection's ending index. For just a cursor in place (no selection), `start` equals `end`.
 
+### `.setTextAlignment()`
+
+```ts
+setTextAlignment: (alignment: 'left' | 'center' | 'right' | 'justify' | 'default') => void;
+```
+
+Sets text alignment for the paragraph(s) at the current selection. When inside a list, the alignment is applied to all contiguous list items.
+
+- `alignment` - the desired text alignment. Use `'default'` to reset to the system natural alignment.
+
 ### `.startMention()`
 
 ```ts

diff --git a/ios/EnrichedTextInputView.mm b/ios/EnrichedTextInputView.mm
@@ -1,4 +1,5 @@
 #import "EnrichedTextInputView.h"
+#import "AlignmentUtils.h"
 #import "AttachmentLayoutUtils.h"
 #import "CoreText/CoreText.h"
 #import "DotReplacementUtils.h"
@@ -58,6 +59,7 @@ @implementation EnrichedTextInputView {
   NSArray<NSDictionary *> *_contextMenuItems;
   NSString *_submitBehavior;
   NSDictionary<NSAttributedStringKey, id> *_capturedAttributesBeforeChange;
+  NSString *_recentlyEmittedAlignment;
 }
 
 @synthesize blockEmitting = blockEmitting;
@@ -128,6 +130,7 @@ - (void)setDefaults {
   _blockedStyles = [[NSMutableSet alloc] init];
   _recentlyActiveLinkRange = NSMakeRange(0, 0);
   _recentlyActiveMentionRange = NSMakeRange(0, 0);
+  _recentlyEmittedAlignment = @"left";
   _recentInputString = @"";
   _recentlyEmittedHtml = @"<html>\n<p></p>\n</html>";
   _emitHtml = NO;
@@ -843,6 +846,20 @@ - (void)refreshPlaceholderLabelStyles {
   if (_placeholderColor != nullptr) {
     newAttrs[NSForegroundColorAttributeName] = _placeholderColor;
   }
+
+  // Get the current active alignment in input
+  NSParagraphStyle *currentTypingPara =
+      textView.typingAttributes[NSParagraphStyleAttributeName];
+  NSTextAlignment activeAlignment =
+      currentTypingPara ? currentTypingPara.alignment : NSTextAlignmentNatural;
+  NSMutableParagraphStyle *placeholderPStyle =
+      [newAttrs[NSParagraphStyleAttributeName] mutableCopy];
+  if (!placeholderPStyle) {
+    placeholderPStyle = [[NSMutableParagraphStyle alloc] init];
+  }
+  placeholderPStyle.alignment = activeAlignment;
+  newAttrs[NSParagraphStyleAttributeName] = placeholderPStyle;
+
   NSAttributedString *newAttrStr =
       [[NSAttributedString alloc] initWithString:_placeholderLabel.text
                                       attributes:newAttrs];
@@ -1052,12 +1069,20 @@ - (void)tryUpdatingActiveStyles {
     }
   }
 
+  // detect alignment change
+  AlignmentStyle *alignmentStyle = stylesDict[@([AlignmentStyle getType])];
+  NSString *currentAlignment = [alignmentStyle getStyleState];
+  if (![currentAlignment isEqualToString:_recentlyEmittedAlignment]) {
+    updateNeeded = YES;
+  }
+
   if (updateNeeded) {
     auto emitter = [self getEventEmitter];
     if (emitter != nullptr) {
       // update activeStyles and blockedStyles only if emitter is available
       _activeStyles = newActiveStyles;
       _blockedStyles = newBlockedStyles;
+      _recentlyEmittedAlignment = currentAlignment;
 
       emitter->onChangeState(
           {.bold = GET_STYLE_STATE([BoldStyle getType]),
@@ -1078,7 +1103,8 @@ - (void)tryUpdatingActiveStyles {
            .blockQuote = GET_STYLE_STATE([BlockQuoteStyle getType]),
            .codeBlock = GET_STYLE_STATE([CodeBlockStyle getType]),
            .image = GET_STYLE_STATE([ImageStyle getType]),
-           .checkboxList = GET_STYLE_STATE([CheckboxListStyle getType])});
+           .checkboxList = GET_STYLE_STATE([CheckboxListStyle getType]),
+           .alignment = [currentAlignment UTF8String]});
     }
   }
 
@@ -1203,6 +1229,20 @@ - (void)handleCommand:(const NSString *)commandName args:(const NSArray *)args {
   } else if ([commandName isEqualToString:@"requestHTML"]) {
     NSInteger requestId = [((NSNumber *)args[0]) integerValue];
     [self requestHTML:requestId];
+  } else if ([commandName isEqualToString:@"setTextAlignment"]) {
+    NSString *alignmentString = (NSString *)args[0];
+
+    AlignmentStyle *alignmentStyle = stylesDict[@([AlignmentStyle getType])];
+    [alignmentStyle
+          addAlignment:[AlignmentUtils stringToAlignment:alignmentString]
+                 range:textView.selectedRange
+            withTyping:YES
+        withDirtyRange:YES];
+
+    [self anyTextMayHaveBeenModified];
+    if (!_placeholderLabel.isHidden) {
+      [self refreshPlaceholderLabelStyles];
+    }
   }
 }
 
@@ -1768,6 +1808,9 @@ - (void)emitOnContextMenuItemPressEvent:(NSString *)itemText {
           [textView.textStorage.string substringWithRange:selectedRange];
     }
 
+    AlignmentStyle *alignmentStyle = stylesDict[@([AlignmentStyle getType])];
+    NSString *currentAlignment = [alignmentStyle getStyleState];
+
     emitter->onContextMenuItemPress(
         {.itemText = [itemText toCppString],
          .selectedText = [selectedText toCppString],
@@ -1793,7 +1836,8 @@ - (void)emitOnContextMenuItemPressEvent:(NSString *)itemText {
              .link = GET_STYLE_STATE([LinkStyle getType]),
              .image = GET_STYLE_STATE([ImageStyle getType]),
              .mention = GET_STYLE_STATE([MentionStyle getType]),
-             .checkboxList = GET_STYLE_STATE([CheckboxListStyle getType])}});
+             .checkboxList = GET_STYLE_STATE([CheckboxListStyle getType]),
+             .alignment = [currentAlignment UTF8String]}});
   }
 }
 

diff --git a/ios/enrichedInputTextView/EnrichedInputTextView/EnrichedInputTextView.mm b/ios/enrichedInputTextView/EnrichedInputTextView/EnrichedInputTextView.mm
@@ -1,8 +1,10 @@
 #import "EnrichedInputTextView.h"
+#import "AlignmentUtils.h"
 #import "EnrichedTextInputView.h"
 #import "HtmlParser.h"
 #import "StringExtension.h"
 #import "TextInsertionUtils.h"
+#import "TextListUtils.h"
 #import <UniformTypeIdentifiers/UniformTypeIdentifiers.h>
 
 @implementation EnrichedInputTextView
@@ -18,6 +20,48 @@ - (void)layoutSubviews {
   }
 }
 
+// UITextView places the cursor at the leading edge when a paragraph contains
+// zero (or invisible) glyphs because the layout engine has nothing to align.
+// We fix this by reading the active alignment and repositioning the caret rect
+- (CGRect)caretRectForPosition:(UITextPosition *)position {
+  CGRect rect = [super caretRectForPosition:position];
+  NSUInteger idx = [self offsetFromPosition:self.beginningOfDocument
+                                 toPosition:position];
+  NSString *text = self.textStorage.string;
+  NSRange paraRange = [text paragraphRangeForRange:NSMakeRange(idx, 0)];
+
+  // Determine whether the paragraph contains no visible characters.
+  BOOL isEmpty = NO;
+  if (paraRange.length == 0) {
+    isEmpty = YES;
+  }
+
+  if (!isEmpty) {
+    return rect;
+  }
+
+  NSParagraphStyle *pStyle =
+      self.typingAttributes[NSParagraphStyleAttributeName];
+
+  if (pStyle == nil) {
+    return rect;
+  }
+
+  NSString *marker = [TextListUtils firstTextListWithPrefix:@"EnrichedAlignment"
+                                                    inArray:pStyle.textLists]
+                         .markerFormat;
+  NSTextAlignment alignment = [AlignmentUtils markerToAlignment:marker];
+  CGFloat containerWidth = self.textContainer.size.width;
+
+  if (alignment == NSTextAlignmentCenter) {
+    rect.origin.x = (containerWidth - rect.size.width) / 2.0;
+  } else if (alignment == NSTextAlignmentRight) {
+    rect.origin.x = containerWidth - rect.size.width;
+  }
+
+  return rect;
+}
+
 - (void)copy:(id)sender {
   EnrichedTextInputView *typedInput = (EnrichedTextInputView *)_input;
   if (typedInput == nullptr) {