## Usage

The `<Box />` is a primitive layout component that is heavily used to build other components, but can also be used to create custom layouts and components in your app.

```tsx live
<Box>I am a Box</Box>
```

## As

By default, it renders a `<div>`. You can render it with a different HTML element tag by using the `as` prop:

```tsx live
<Box as="button">I am a Box rendered as a button</Box>
```

## Styles

Apply styles like padding, margin, border radius, background color and more, by using available [props](/packages/box/props). Here's a small example:

```tsx live
<>
  <Box padding="small" borderRadius="medium" backgroundColor="neutralSubtle">
    I am a styled Box
  </Box>

  <Box
    marginTop="medium"
    padding="small"
    borderRadius="small"
    borderWidth="thin"
    borderColor="neutralSubtle"
    borderStyle="solid"
    backgroundColor="neutral"
  >
    I am a differently styled Box
  </Box>
</>
```

## Responsive

The `<Box />` component supports the [responsive prop syntax](/foundations/responsive-layouts#responsive-prop-syntax) on most props (for a full list see [props](/packages/box/props)). Try resizing your viewport to see the effects in the examples below.

Use the breakpoint names to define a value at that minimum width:

```tsx live
<Box
  padding={{
    xsmall: 'xxsmall',
    small: 'xsmall',
    medium: 'small',
    large: 'medium',
    xlarge: 'large',
  }}
  backgroundColor="neutralSubtle"
>
  I am a Box with responsive padding
</Box>
```

If you want to skip over a breakpoint, you can do so by excluding it:

```tsx live
<Box padding={{ xsmall: 'xsmall', xlarge: 'large' }} backgroundColor="neutralSubtle">
  I am a Box with responsive padding
</Box>
```

Accessibility

Responsive layouts

Tokens

Foundations

a11y

Accordion

Actions

AddressInput

AppLayout

Avatar

Badge

Blanket

Breadcrumbs

BulkActionBar

Button

Card

Checkbox

Core

DateDropdown

DateInput

Divider

EmptyState

Field

Fieldset

FileInput

Filtering

Flex

Grid

Heading

Icon

Illustration

Link

List

Loading

Modal

Notice

PageHeader

Pagination

PhoneInput

Popover

Radio

RailTrack

RichTextEditor

ScrollWrap

SearchInput

SelectDropdown

SelectInput

ShowMore

Table

Tabs

Text

TextAreaInput

TextInput

Toast

Toggle

Tooltip

Utils

Utils - NextJS

Components

Forms

Search

Tables

Patterns

Introduction

Product tone and voice

Capitalisation

Date and time

Inclusive design

Content

Welcome to EDS

Start designing

Start developing

Contributing

Releases

The EDS way

Coding style guide

Guide to Pendo

Setting up the EDS repo

Creating a new component

Automated testing

PR and changeset process

Publishing snapshots

Publishing packages

Monorepo tools

Team resources