argyleink / argyleink/open-props

Installation is Confusing

Open
#565 2 comments 4 reactions 0 assignees View on GitHub
Dominant language
HTML
Stars
5.5k
Forks
216
PR merge metrics
No merged PRs in 30d

Description

Total noob to OP here, but a long-time developer and I have to say that understanding what to do with all these CSS files is confusing.

Context

I want to use OP in my project: a simple HTML project where I want to write CSS and use the properties in my `.css` files. I want to avoid `@import` and any build steps. I just want to load in the CSS file(s) and use the properties.

A nice-to-have would be to be able to load in .css files for props I want to use, e.g. I would _not_ load in `animations.css` if I'm not using any animations, etc—just to keep my CSS as lean as possible. But honestly, if the file was small enough, a single `.css` file with everything I need would also be great.

The Confusion

But, I don't even know where to start honestly. https://open-props.style/#getting-started does not make it clear what I need to load in and when and why. For instance does `open-props.min.css` give me everything? Is it the base I need and then load in other "PropPacks?" I understand that `normalize.min.css`, `theme.dark.css` etc use the props, but from where? What do I need to load in so it works? From `open-props.min.css`? Where do I get paddings? Margins?

...anyhow. What to do is too confusing for someone like me who just wants to use the thing.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the getting-started page linked in the issue and review how open-props.min.css, normalize.min.css, theme.dark.css, and the other CSS files are described. Clarify what must be loaded for a basic HTML project, how optional files such as animations.css can be used, and where properties such as padding and margins come from.

Written by the indexing model from the issue text.

Assessment

Tech stack
css
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.