# Portfolio Design Portfolio: Design Principles

A ruled three-column grid of six numbered working principles, each pairing a short titled belief with an honest explanation of its impact.

- Page: https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/design-principles
- Collection: [Portfolio](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro), Standard tier
- Group: [Design Portfolio](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/design-principles.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/portfolio-pro-design-portfolio-design-principles
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- Installs to: `@/components/blocks/portfolio-pro/design-portfolio/design-principles`

## About this block

Design Principles lays out six numbered working beliefs
in a ruled three-column grid, each pairing a short title
(Clarity over cleverness, Edge cases are the design,
Words are interface) with an honest note on how it
changes what ships. The section opens with a "What I
optimize for" heading and a line explaining that the
list settles most arguments before they start.

Principles are one typed array; each cell carries a
tabular number, a title, and a body, divided by a top
border rather than card chrome. The honesty is the
point: principle 04 admits taste generates the options
but a five-user test picks the winner, so the list reads
as a real point of view, not slogans.

## When to use

Reach for this block on an about or services page where
a designer's judgment is the thing being sold. The
installer swaps the six titles and bodies for their own
convictions, keeping each one specific enough that a
client can tell how a future call will go.

A natural flow around it on a Portfolio Pro page:

**Before**

- [About sections](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/about-sections)

**After**

- [Services sections](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/services-sections)
- [Testimonials](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/testimonials)

## What you can display

One strong use is a design philosophy statement. Other
principle layouts:

- **Studio values.** Rewrite the bodies in the first
  person plural for an agency about page.
- **Engineering principles.** Adapt the titles to
  testing, review, and shipping habits for a developer
  portfolio.
- **Editorial standards.** Turn the grid into house
  style rules for a writing portfolio.

> Tip: a principle only earns trust when it costs
> something; keep each body honest about the tradeoff it
> makes rather than listing beliefs everyone shares.

## More in Portfolio Design Portfolio

- [Annotated Screen](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/annotated-screen)
- [Before After Design](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/before-after-design)
- [Brand Showcase](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/brand-showcase)
- [Case Study Design](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/case-study-design)
- [Concept Grid](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/concept-grid)
- [Design Directions](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/design-directions)
- [Design Process](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/design-process)
- [Design System Display](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/design-system-display)
- [Featured Project](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/featured-project)
- [Iteration Timeline](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/iteration-timeline)
- [Logo Grid](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/logo-grid)
- [Project Index](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/project-index)
- [Research Decisions](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/research-decisions)
- [Responsive Pairs](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/responsive-pairs)
- [Screens Carousel Blueprint](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/screens-carousel-blueprint)
- [UI Wall](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/ui-wall)
- [Visual Grid](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/visual-grid)
- [Work Showcase](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/work-showcase)
