diff --git a/.swiftlint.yml b/.swiftlint.yml
index 89efd09..4e5cbac 100644
--- a/.swiftlint.yml
+++ b/.swiftlint.yml
@@ -11,7 +11,6 @@ disabled_rules:
   - opening_brace
 
 opt_in_rules: # some rules are only opt-in
-  - anyobject_protocol
   - array_init
   - attributes
   - closure_body_length
@@ -125,7 +124,7 @@ large_tuple:
 nesting:
   type_level:
     warning: 2
-  statement_level:
+  function_level:
     warning: 10
 
 
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index e6661d0..ada40e2 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,61 +1,439 @@
-# Contributing Guidelines
+# Contributing to Snacker
 
-This document contains information and guidelines about contributing to this project.
-Please read it before you start participating.
+First off, thank you for considering contributing to Snacker! It's people like you that make Snacker such a great tool for the iOS community.
 
-**Topics**
+## Table of Contents
 
-* [Reporting Issues](#reporting-issues)
-* [Submitting Pull Requests](#submitting-pull-requests)
-* [Developers Certificate of Origin](#developers-certificate-of-origin)
 * [Code of Conduct](#code-of-conduct)
+* [Getting Started](#getting-started)
+* [Development Setup](#development-setup)
+* [Project Structure](#project-structure)
+* [How Can I Contribute?](#how-can-i-contribute)
+* [Reporting Bugs](#reporting-bugs)
+* [Suggesting Features](#suggesting-features)
+* [Improving Documentation](#improving-documentation)
+* [Submitting Code](#submitting-code)
+* [Development Workflow](#development-workflow)
+* [Branching Strategy](#branching-strategy)
+* [Commit Guidelines](#commit-guidelines)
+* [Pull Request Process](#pull-request-process)
+* [Coding Standards](#coding-standards)
+* [Swift Style Guide](#swift-style-guide)
+* [Code Quality](#code-quality)
+* [Testing Requirements](#testing-requirements)
+* [Community](#community)
 
-## Reporting Issues
+## Code of Conduct
 
-A great way to contribute to the project is to send a detailed issue when you encounter a problem. We always appreciate a well-written, thorough bug report.
+This project and everyone participating in it is governed by our Code of Conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to nv3212@gmail.com.
 
-Check that the project issues database doesn't already include that problem or suggestion before submitting an issue. If you find a match, feel free to vote for the issue by adding a reaction. Doing this helps prioritize the most common problems and requests.
+## Getting Started
 
-When reporting issues, please fill out our issue template. The information the template asks for will help us review and fix your issue faster.
+### Development Setup
 
-## Submitting Pull Requests
+1. **Fork the repository**
+```bash
+# Click the "Fork" button on GitHub
+```
 
-You can contribute by fixing bugs or adding new features. For larger code changes, we recommend first discussing your ideas on our [GitHub Discussions](https://github.com/space-code/snacker/discussions). When submitting a pull request, please add relevant tests and ensure your changes don't break any existing tests.
+2. **Clone your fork**
+```bash
+git clone https://github.com/YOUR_USERNAME/snacker.git
+cd snacker
+```
 
-## Developer's Certificate of Origin 1.1
+3. **Set up the development environment**
+```bash
+# Bootstrap the project
+make bootstrap
+```
 
-By making a contribution to this project, I certify that:
+4. **Create a feature branch**
+```bash
+git checkout -b feature/your-feature-name
+```
 
-- (a) The contribution was created in whole or in part by me and I
-      have the right to submit it under the open source license
-      indicated in the file; or
+5. **Open the project in Xcode**
+```bash
+open Package.swift
+```
 
-- (b) The contribution is based upon previous work that, to the best
-      of my knowledge, is covered under an appropriate open source
-      license and I have the right under that license to submit that
-      work with modifications, whether created in whole or in part
-      by me, under the same open source license (unless I am
-      permitted to submit under a different license), as indicated
-      in the file; or
+## How Can I Contribute?
 
-- (c) The contribution was provided directly to me by some other
-      person who certified (a), (b) or (c) and I have not modified
-      it.
+### Reporting Bugs
 
-- (d) I understand and agree that this project and the contribution
-      are public and that a record of the contribution (including all
-      personal information I submit with it, including my sign-off) is
-      maintained indefinitely and may be redistributed consistent with
-      this project or the open source license(s) involved.
+Before creating a bug report, please check the [existing issues](#https://github.com/space-code/snacker/issues) to avoid duplicates.
 
-## Code of Conduct
+When creating a bug report, include:
+
+* **Clear title** - Describe the issue concisely
+* **Reproduction steps** - Detailed steps to reproduce the bug
+* **Expected behavior** - What you expected to happen
+* **Actual behavior** - What actually happened
+* **Environment** - OS, Xcode version, Swift version
+* **Code samples** - Minimal reproducible example
+* **Screenshots/Video** - Visual proof of UI glitches (highly recommended for Snacker)
+
+**Example:**
+
+```markdown
+**Title:** Snackbar ignores safe area on iPhone 15 Pro
+
+**Steps to reproduce:**
+1. Call Snacker.shared.action with `.bottom` alignment
+2. Rotate device to landscape
+3. Observe snackbar overlapping the home indicator
+
+**Expected:** Snackbar should respect safe area insets
+**Actual:** Snackbar is clipped by the screen edge/home indicator
+
+**Environment:**
+- iOS 17.0
+- Xcode 16.0
+- Swift 6.0
+
+**Code:**
+\`\`\`swift
+Snacker.shared.action(
+    .snack(view: myView, data: .init(snackbarAlignment: .bottom(spacing: 0))),
+    container: window
+)
+\`\`\`
+```
+
+### Suggesting Features
+
+We love feature suggestions! When proposing a new feature, include:
+
+* **Problem statement** - What problem does this solve?
+* **Proposed solution** - How should it work?
+* **Alternatives** - What alternatives did you consider?
+* **Use cases** - Real-world scenarios
+* **API design** - Example code showing usage
+* **Visuals** - Mockups or sketches if applicable
+
+**Example:**
+
+```markdown
+**Feature:** Swipe to dismiss
+
+**Problem:** Users cannot manually dismiss a snackbar before the duration expires.
+
+**Solution:** Add gesture recognizer to the container view to allow swiping the snackbar away.
+
+**API:**
+\`\`\`swift
+let data = SnackbarData(
+    snackbarAlignment: .top,
+    interaction: .swipeToDismiss(direction: .up) // New parameter
+)
+\`\`\`
+
+**Use case:** Error messages that block content which the user has already read.
+```
+
+### Improving Documentation
+
+Documentation improvements are always welcome:
+
+* **Code comments** - Add/improve inline documentation
+* **DocC documentation** - Enhance documentation articles
+* **README** - Fix typos, add visual examples
+* **Guides** - Write tutorials on creating custom views
+* **API documentation** - Document public APIs
+
+### Submitting Code
+
+1. **Check existing work** - Look for related issues or PRs
+2. **Discuss major changes** - Open an issue for large features
+3. **Follow coding standards** - See [Coding Standards](#coding-standards)
+4. **Write tests** - All code changes require tests (logic & UI snapshots if possible)
+5. **Update documentation** - Keep docs in sync with code
+6. **Create a pull request** - Use clear description
+
+## Development Workflow
 
-The Code of Conduct governs how we behave in public or in private
-whenever the project will be judged by our actions.
-We expect it to be honored by everyone who contributes to this project.
+### Branching Strategy
 
-See [CODE_OF_CONDUCT.md](https://github.com/space-code/snacker/blob/master/CODE_OF_CONDUCT.md) for details.
+We use a simplified branching model:
+
+* **`main`** - Main development branch (all PRs target this)
+* **`feature/*`** - New features
+* **`fix/*`** - Bug fixes
+* **`docs/*`** - Documentation updates
+* **`refactor/*`** - Code refactoring
+* **`test/*`** - Test improvements
+
+**Branch naming examples:**
+
+```bash
+feature/swipe-to-dismiss
+fix/safe-area-calculation
+docs/add-custom-view-example
+refactor/animation-coordinator
+test/add-queue-tests
+```
+
+### Commit Guidelines
+
+We use [Conventional Commits](https://www.conventionalcommits.org/) for clear, structured commit history.
+
+**Format:**
+
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+**Types:**
+
+* `feat` - New feature
+* `fix` - Bug fix
+* `docs` - Documentation changes
+* `style` - Code style (formatting, no logic changes)
+* `refactor` - Code refactoring
+* `test` - Adding or updating tests
+* `chore` - Maintenance tasks
+
+**Scopes:**
+
+* `core` - Core logic (Manager)
+* `ui` - View components
+* `animation` - Transitions and animations
+* `layout` - Constraints and positioning
+* `deps` - Dependencies
+
+**Examples:**
+
+```bash
+feat(animation): add spring configuration support
+
+Allow users to customize spring damping and velocity for
+smoother snackbar appearance.
+
+Closes #12
+
+---
+
+fix(layout): correct bottom spacing on iPad
+
+iPad multitasking mode was causing incorrect width calculation.
+Now uses safeAreaLayoutGuide correctly relative to container.
+
+Fixes #23
 
 ---
 
-*Some of the ideas and wording for the statements above were based on work by the [Docker](https://github.com/docker/docker/blob/master/CONTRIBUTING.md) and [Linux](https://elinux.org/Developer_Certificate_Of_Origin) communities.
\ No newline at end of file
+docs(readme): add screenshot for custom view
+
+Update README to show how a custom success toast looks
+with the new styling options.
+
+---
+
+test(core): ensure queue order is preserved
+
+Add tests to verify that multiple snackbar requests are
+shown sequentially and not overlapping.
+
+```
+
+### Pull Request Process
+
+1. **Update your branch**
+```bash
+git checkout main
+git pull upstream main
+git checkout feature/your-feature
+git rebase main
+```
+
+2. **Run tests and checks**
+```bash
+# Run all tests
+swift test
+```
+
+3. **Push to your fork**
+```bash
+git push origin feature/your-feature
+```
+
+4. **Create pull request**
+* Target the `main` branch
+* Provide clear description
+* Link related issues
+* **Attach screen recordings** for UI changes
+* Request review from maintainers
+
+## Coding Standards
+
+### Swift Style Guide
+
+We follow the [Swift API Design Guidelines](https://swift.org/documentation/api-design-guidelines/) and [Ray Wenderlich Swift Style Guide](https://github.com/raywenderlich/swift-style-guide).
+
+**Key points:**
+
+1. **Naming**
+```swift
+// ✅ Good
+func show(view: UIView, data: SnackbarData)
+let animationDuration: TimeInterval
+
+// ❌ Bad
+func doSnack(_ v: UIView, _ d: SnackbarData)
+let dur: Double
+```
+
+2. **Protocols**
+```swift
+// ✅ Good - Use "I" prefix for protocols (Project Convention)
+protocol ISnackbarManager {
+    func schedule(_ action: SnackAction)
+}
+
+// ❌ Bad
+protocol SnackbarManagerProtocol { }
+```
+
+3. **Access Control**
+```swift
+// ✅ Good - Explicit access control
+public final class Snacker {
+    public static let shared = Snacker()
+
+    private let queue: DispatchQueue
+
+    private init() {
+        self.queue = DispatchQueue(label: "com.snacker.queue")
+    }
+}
+```
+
+4. **Documentation**
+```swift
+/// Displays a snackbar with custom configuration.
+///
+/// Use this method to present a transient notification view on top of
+/// the current context. The view will be automatically dismissed
+/// after the duration specified in `data`.
+///
+/// - Parameters:
+///   - action: The action containing the view and configuration data.
+///   - container: The window or view controller view to host the snackbar.
+///
+/// - Example:
+/// ```swift
+/// Snacker.shared.action(.snack(view: v, data: d), container: window)
+/// ```
+public func action(_ action: SnackAction, container: UIView) {
+    // Implementation
+}
+
+```
+
+### Code Quality
+
+* **No force unwrapping** - Use optional binding or guards
+* **No force casting** - Use conditional casting
+* **UI on Main Thread** - Ensure all UI updates happen on `@MainActor`
+* **Memory Management** - Watch out for retain cycles in closures (animations)
+* **SOLID principles** - Follow SOLID design
+
+**Example:**
+
+```swift
+// ✅ Good
+@MainActor
+func present(_ view: UIView) {
+    guard let superview = container else { return }
+    superview.addSubview(view)
+}
+
+// ❌ Bad
+func present(_ view: UIView) {
+    // Might crash if called from background
+    container!.addSubview(view) 
+}
+```
+
+### Testing Requirements
+
+All code changes must include tests:
+
+1. **Unit tests** - Test queue logic and data models
+2. **Snapshot tests** - (Optional but recommended) Verify UI rendering
+3. **Integration tests** - Test interaction between Manager and Views
+
+**Coverage requirements:**
+
+* New code: minimum 80% coverage
+* Modified code: maintain or improve existing coverage
+
+**Test structure:**
+
+```swift
+import XCTest
+@testable import Snacker
+
+final class SnackerManagerTests: XCTestCase {
+    var sut: Snacker!
+    
+    override func setUp() {
+        super.setUp()
+        sut = Snacker()
+    }
+    
+    override func tearDown() {
+        sut = nil
+        super.tearDown()
+    }
+    
+    // MARK: - Queue Tests
+    
+    func testAction_WhenQueueEmpty_ShowsImmediately() {
+        // Given
+        let view = UIView()
+        let expectation = expectation(description: "View shown")
+        
+        // When
+        sut.action(.snack(view: view, data: .default), container: UIView())
+        
+        // Then
+        // Verify state change...
+        expectation.fulfill()
+        wait(for: [expectation], timeout: 1.0)
+    }
+}
+
+```
+
+## Community
+
+* **Discussions** - Join [GitHub Discussions](#https://github.com/space-code/snacker/discussions)
+* **Issues** - Track [open issues](#https://github.com/space-code/snacker/issues)
+* **Pull Requests** - Review [open PRs](#https://github.com/space-code/snacker/pulls)
+
+## Recognition
+
+Contributors are recognized in:
+
+* GitHub contributors page
+* Release notes
+* Project README (for significant contributions)
+
+## Questions?
+
+* Check [existing issues](https://github.com/space-code/snacker/issues)
+* Search [discussions](https://github.com/space-code/snacker/discussions)
+* Ask in [Q&A discussions](https://github.com/space-code/snacker/discussions/categories/q-a)
+* Email the maintainer: nv3212@gmail.com
+
+---
+
+Thank you for contributing to Snacker! 🎉
+
+Your efforts help make this project better for everyone.
\ No newline at end of file
diff --git a/README.md b/README.md
index 4934766..4b4662b 100644
--- a/README.md
+++ b/README.md
@@ -7,69 +7,163 @@
 <a href="https://github.com/space-code/snacker"><img alt="CI" src="https://github.com/space-code/snacker/actions/workflows/ci.yml/badge.svg?branch=main"></a>
 
 ## Description
-`snacker` is a lightweight Swift library for displaying snackbars in iOS applications.
+Snacker is a modern, lightweight Swift framework for displaying customizable snackbars and toast notifications in iOS applications. Designed with simplicity in mind, it allows developers to present any custom view as a non-intrusive notification with flexible positioning and smooth animations.
+
+## Features
+✨ Custom Views — Display any UIView as a snackbar  
+📐 Flexible Positioning — Support for top and bottom screen alignments  
+🎬 Smooth Animations — Fully configurable transition durations  
+🎯 Simple API — Single-line execution via a shared service  
+📱 Modern Swift — Built for Swift 6.0 and iOS 17.0+  
+⚡ Lightweight — Minimal overhead with zero external dependencies  
+🧪 Well Tested — Reliable performance for production environments  
+
+## Table of Contents
+
+* [Requirements](#requirements)
+* [Installation](#installation)
+* [Quick Start](h#quick-start)
+* [Usage](#usage)
+* [Custom View Implementation](#custom-view-implementation)
+* [Communication](#communication)
+* [Contributing](#contributing)
+* [Development Setup](#development-setup)
 
-- [Usage](#usage)
-- [Requirements](#requirements)
-- [Installation](#installation)
-- [Communication](#communication)
-- [Contributing](#contributing)
-- [Author](#author)
-- [License](#license)
+## Requirements
 
-## Usage
+| Platform | Minimum Version |
+| --- | --- |
+| iOS | 17.0+ |
+| Xcode | 16.0+ |
+| Swift | 6.0+ |
+
+## Installation
+
+### Swift Package Manager
+
+Add the following dependency to your `Package.swift`:
+
+```swift
+dependencies: [
+    .package(url: "https://github.com/space-code/snacker.git", from: "1.0.0")
+]
+
+```
+
+Or add it through Xcode:
+
+1. File > Add Package Dependencies
+2. Enter package URL: `https://github.com/space-code/snacker.git`
+3. Select version requirements
+
+## Quick Start
 
 ```swift
-import Snackner
+import Snacker
+
+let myView = MyCustomView() // Any UIView subclass
 
 Snacker.shared.action(
     .snack(
-        view: view,
+        view: myView,
         data: SnackbarData(
             snackbarAlignment: .top(spacing: 20),
-            insets: .zero,
             animationDuration: 0.25
         )
     ),
     container: window
 )
-```
-
-## Requirements
 
-- iOS 17.0+
-- Xcode 16.0
-- Swift 6.0
+```
 
-## Installation
-### Swift Package Manager
+## Usage
 
-The [Swift Package Manager](https://swift.org/package-manager/) is a tool for automating the distribution of Swift code and is integrated into the `swift` compiler. It is in early development, but `snacker` does support its use on supported platforms.
+### Custom View Implementation
 
-Once you have your Swift package set up, adding `snacker` as a dependency is as easy as adding it to the `dependencies` value of your `Package.swift`.
+You can display any view as a snackbar. Here is a practical example of creating and presenting a simple information toast:
 
 ```swift
-dependencies: [
-    .package(url: "https://github.com/space-code/snacker.git", .upToNextMajor(from: "1.0.0"))
-]
+import UIKit
+import Snacker
+
+// 1. Define your custom notification view
+final class InfoToastView: UIView {
+    private let messageLabel = UILabel()
+
+    init(text: String) {
+        super.init(frame: .zero)
+        backgroundColor = .secondarySystemBackground
+        layer.cornerRadius = 10
+        
+        messageLabel.text = text
+        messageLabel.textAlignment = .center
+        messageLabel.translatesAutoresizingMaskIntoConstraints = false
+        
+        addSubview(messageLabel)
+        NSLayoutConstraint.activate([
+            messageLabel.topAnchor.constraint(equalTo: topAnchor, constant: 12),
+            messageLabel.bottomAnchor.constraint(equalTo: bottomAnchor, constant: -12),
+            messageLabel.leadingAnchor.constraint(equalTo: leadingAnchor, constant: 16),
+            messageLabel.trailingAnchor.constraint(equalTo: trailingAnchor, constant: -16)
+        ])
+    }
+
+    required init?(coder: NSCoder) { fatalError() }
+}
+
+// 2. Present the snackbar
+func notifyUser() {
+    let toast = InfoToastView(text: "New message received!")
+    
+    let config = SnackbarData(
+        snackbarAlignment: .bottom(spacing: 50),
+        insets: UIEdgeInsets(top: 0, left: 20, bottom: 0, right: 20),
+        animationDuration: 0.3
+    )
+    
+    Snacker.shared.action(
+        .snack(view: toast, data: config),
+        container: self.view.window
+    )
+}
+
 ```
 
 ## Communication
-- If you **found a bug**, open an issue.
-- If you **have a feature request**, open an issue.
-- If you **want to contribute**, submit a pull request.
+
+- 🐛 **Found a bug?** [Open an issue](https://github.com/space-code/typhoon/issues/new)
+- 💡 **Have a feature request?** [Open an issue](https://github.com/space-code/typhoon/issues/new)
+- ❓ **Questions?** [Start a discussion](https://github.com/space-code/typhoon/discussions)
+- 🔒 **Security issue?** Email nv3212@gmail.com
 
 ## Contributing
-Bootstrapping development environment
 
-```
-make bootstrap
-```
+We love contributions! Please feel free to help out with this project. If you see something that could be made better or want a new feature, open up an issue or send a Pull Request.
 
-Please feel free to help out with this project! If you see something that could be made better or want a new feature, open up an issue or send a Pull Request!
+### Development Setup
+
+Bootstrap the development environment:
+
+```bash
+mise install
+```
 
 ## Author
-Nikita Vasilev, nv3212@gmail.com
+
+**Nikita Vasilev**
+- Email: nv3212@gmail.com
+- GitHub: [@ns-vasilev](https://github.com/ns-vasilev)
 
 ## License
-snacker is available under the MIT license. See the LICENSE file for more info.
+
+Snacker is released under the MIT license. See [LICENSE](https://github.com/space-code/snacker/blob/main/LICENSE) for details.
+
+---
+
+<div align="center">
+
+**[⬆ back to top](https://www.google.com/search?q=%23snacker)**
+
+Made with ❤️ by [space-code](https://github.com/space-code)
+
+</div>
\ No newline at end of file
diff --git a/Sources/snacker/Classes/Presentation/SnackbarController.swift b/Sources/snacker/Classes/Presentation/SnackbarController.swift
index a110e61..64bcde7 100644
--- a/Sources/snacker/Classes/Presentation/SnackbarController.swift
+++ b/Sources/snacker/Classes/Presentation/SnackbarController.swift
@@ -96,13 +96,10 @@ extension SnackbarController {
                 withDuration: 0.5,
                 delay: .zero,
                 options: .curveEaseInOut,
-                animations: { [weak self] in
-                    guard let self else {
-                        return
-                    }
-                    NSLayoutConstraint.deactivate(disabledConstraints)
-                    NSLayoutConstraint.activate(activeConstraints)
-                    containerView.layoutIfNeeded()
+                animations: {
+                    NSLayoutConstraint.deactivate(self.disabledConstraints)
+                    NSLayoutConstraint.activate(self.activeConstraints)
+                    self.containerView.layoutIfNeeded()
                 },
                 completion: { _ in
                     completion?()
@@ -123,12 +120,9 @@ extension SnackbarController {
                 withDuration: 0.5,
                 delay: .zero,
                 options: .curveEaseInOut,
-                animations: { [weak self] in
-                    guard let self else {
-                        return
-                    }
-                    NSLayoutConstraint.activate(disabledConstraints)
-                    containerView.layoutIfNeeded()
+                animations: {
+                    NSLayoutConstraint.activate(self.disabledConstraints)
+                    self.containerView.layoutIfNeeded()
                 },
                 completion: { [weak self] _ in
                     self?.contentView.removeFromSuperview()