# Neeldhara Blogs

This repository is a monorepo for seven Astro blogs. Each site lives under
`sites/<name>` and can evolve independently with its own theme, dependencies,
RSS feed, and Dokploy application.

## Sites

- `sites/research`
- `sites/vibes`
- `sites/puzzles`
- `sites/reflections`
- `sites/poetry`
- `sites/reviews`
- `sites/art`

## Local Development

```bash
npm install

# Run the default research site
npm run dev:research

# Or run a specific site directly
npm run dev --prefix sites/puzzles
```

Open [http://localhost:4321](http://localhost:4321) with your browser to see the result.

Build every site:

```bash
npm run build:sites
```

Build one site:

```bash
npm run build --prefix sites/research
```

## Tech Stack

- Astro 5.x
- Tailwind 4
- shadcn/ui

## Deploy

Deployment is via Forgejo + Dokploy. See [DEPLOYMENT.md](./DEPLOYMENT.md).

## Coral Comments

Post pages embed Coral with `customCSSURL: "/coral-transparent.css"`. Each
site keeps its own copy at `sites/<name>/public/coral-transparent.css`.

That CSS is the durable customization point for Coral UI changes: it is served
by the blog site and loaded by Coral at runtime, so it survives Coral container
rebuilds and image upgrades. It currently makes the embed background
transparent, hides the redundant single "Comments" tab, and suppresses Coral's
fixed-position floating notification bell so it cannot drift over article text.

## Obsidian Content Bridge

The seven blog content folders are synced from the public Obsidian vault. See
[CONTENT_BRIDGE.md](./CONTENT_BRIDGE.md) for conventions, preview/publish
commands, and the Quarto import workflow. See [IMPORT_REPORT.md](./IMPORT_REPORT.md)
for the current imported post mapping.

For the reusable Markdown parser contract shared by Astro HTML and Pandoc/PDF,
see [docs/PARSER.md](./docs/PARSER.md).