Skip to content

Commit 768d553

Browse files
committed
docs: add CSS system, ecosystem filter, and css_file conventions to CLAUDE.md
1 parent d3d4926 commit 768d553

1 file changed

Lines changed: 16 additions & 1 deletion

File tree

notebooks/claude.md

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,24 @@ Never pin a marimo version. The top of every notebook file must have:
3737

3838
```python
3939
__generated_with = "unknown"
40-
app = marimo.App(width="full")
40+
app = marimo.App(width="full", css_file="styles/root.css")
4141
```
4242

43+
The `css_file` path is relative to the notebook file. Use the correct variant:
44+
- Root notebooks (`notebooks/*.py`): `css_file="styles/root.css"`
45+
- Data notebooks (`notebooks/data/**/*.py`): `css_file="../../styles/data.css"`
46+
- Insight notebooks (`notebooks/insights/*.py`): `css_file="../styles/insights.css"`
47+
48+
CSS is built from `notebooks/styles/base.css` + variant partials by `scripts/build_css.py`. Run `uv run scripts/build_css.py` after editing any CSS source file.
49+
50+
### Filter ecosystem queries
51+
52+
When querying `oso.stg_opendevdata__ecosystems` and listing/ranking multiple ecosystems, always add:
53+
```sql
54+
WHERE e.is_crypto = 1 AND e.is_category = 0
55+
```
56+
This filters out ODD's internal category ecosystems. Not needed when filtering by a specific ecosystem name (e.g., `WHERE e.name = 'Ethereum'`).
57+
4358
### Use Trino SQL
4459
All queries run against a Trino data warehouse via pyoso. Write Trino-compatible SQL:
4560
- `DATE_TRUNC('month', dt)` not `DATE_TRUNC(dt, MONTH)`

0 commit comments

Comments
 (0)