About

What is Foundations?

Foundations is an opinionated collection of UI primitives, hooks, utilities, and guides for building modern web products. It’s designed to be copied into your project — not installed as a dependency.

Each piece is meant to be self-contained, readable, and easy to adapt — so you can take what you need and shape it to your project.

How to use Foundations

There are two main ways to use Foundations:

1. Copy and Customize: Take the components, patterns, or entire feature implementations you need and integrate them directly into your project. Each solution is designed to be self-contained and easily customizable. This approach gives you full control over the code and allows you to modify it to match your specific requirements.

2. Learning Resource: Use Foundations as a reference and learning tool. Study our implementation patterns, from accessibility considerations in UI components to complex state management in applications, or content modeling for data-heavy products. This knowledge can help you build your own solutions from scratch with confidence.

Project context

Foundations was created by Significa as an internal resource to:

• Document our approaches and best practices for building digital products
• Bootstrap new projects with proven, production-ready solutions
• Speed up development while maintaining high standards for user experience, accessibility, and performance
• Share knowledge and promote good practices within our team
• Standardize our approach to common challenges in web development

Project inspirations

Foundations draws inspiration from a few projects in the developer community:

• shadcn/ui — for its approach to component distribution and documentation
• Lucia Auth — for its documentation structure and learning resources

Philosophy

The code is meant to be read. You copy it into your project, understand it, and shape it to fit. There’s no CLI and no registry, by design. Dependencies are kept to a minimum and almost everything is built from scratch, so the codebase and the roadmap stay fully owned.

Getting Started

Ready to dive in? Check out the Setup guide to start using Foundations in your project, or explore our UI components to see what’s available.