mdb1

import Foundation

extension String {
    /// Returns the localized value for the given key (`self`).
    /// This property will look in the `Localizable.strings` file based on the current system language.
    ///
    /// Usage
    /// ===================================
    /// ```swift
    /// "key".localized

mdb1

import SwiftUI

struct ContentView: View {
    let name: String

    var body: some View {
        VStack {
            Text(ViewConstants.title.localized(with: [name]))
            Text(ViewConstants.description)
        }

mdb1

# format options
--allman false
--indent 4
--maxwidth 120
--commas inline
--decimalgrouping 3
--wraparguments before-first

# rules
--enable isEmpty

mdb1

Contributing

This is a living document representing some guidelines that will help our team do great work, and keep consistency in the codebase and the systems over time.

Code Quality Principles

• Naming → Explicitness, brevity, and consistency.
• Commenting → Exist to help future readers (including yourself).
• Testing:
• Code isn’t high quality without tests.

mdb1

/// Extension to apply a RoundedOverlayBorder modifier.
extension View {
    /// Adds a rounded overlay border to the view.
    func roundedOverlayBorder(
        cornerRadius: CGFloat,
        color: Color = .gray,
        lineWidth: CGFloat = 1
    ) -> some View {
        modifier(
            RoundedOverlayBorderModifier(

mdb1

extension View {
    /// View modifier that embeds the content inside a scroll view.
    func scrollable(axis: Axis.Set = .vertical) -> some View {
        modifier(
            ScrollViewModifier(axis: axis)
        )
    }
}

/// A modifier that embeds the content inside a scroll view.

mdb1

import SwiftUI

/// A button with 4 states:
/// * `initial`: The only state where the button can be tapped.
/// * `loading`: Displays a progress view to the right of the text.
/// * `success`: Changes the background color to a success color.
/// * `error`: Changes the background color to an error color.
struct LoadingButton: View {
    private var title: String
    private var loadingTitle: String?

mdb1

import SwiftUI

/// A button that needs to be pressed for a given amount of seconds before executing it's action.
/// It contain 4 states:
/// * `initial`: The only state where the button can be tapped.
/// * `loading`: Displays a progress view to the right of the text.
/// * `success`.
/// * `error`.
struct LongPressButton: View {
    @GestureState private var isHighlighted = false

mdb1

import SwiftUI

/// In this example:
/// * The view model holds and publishes the view state wrapper value.
/// * The view reacts to changes by holding an @StateObject reference to the view model.
/// * The initial loading is an empty screen with a ProgressView in the middle.
/// * Once we have some data, the subsequent loadings will not override the loaded data,
/// and instead, will just display a ProgressView in the toolbar.
struct ViewStateExampleView: View {
    @StateObject private var viewModel: ViewModel = .init()

mdb1

import Foundation

/// Enum that represents the state of a view that loads information from the backend.
enum ViewState<Info: Any> {
    /// Represents non state. Useful when used in combination with other ViewState.
    case initial
    /// Represents the loading state.
    case loading
    /// Represents an error.
    case error(_: Error)