# termi-blog

Monorepo for the Termi blog system.

## Structure

```text
.
├─ frontend/   # Astro blog frontend
├─ backend/    # Loco.rs backend and admin
├─ mcp-server/ # Streamable HTTP MCP server for articles/categories/tags
├─ .codex/     # Codex workspace config
└─ .vscode/    # Editor workspace config
```

## Run

### Monorepo scripts

From the repository root:

```powershell
.\dev.ps1
```

Frontend + backend + MCP:

```powershell
.\dev.ps1 -WithMcp
```

Only frontend:

```powershell
.\dev.ps1 -FrontendOnly
```

Only backend:

```powershell
.\dev.ps1 -BackendOnly
```

Only MCP:

```powershell
.\dev.ps1 -McpOnly
```

Direct scripts:

```powershell
.\start-frontend.ps1
.\start-backend.ps1
.\start-mcp.ps1
```

### Frontend

```powershell
cd frontend
npm install
npm run dev
```

### Backend

```powershell
cd backend
$env:DATABASE_URL="postgres://postgres:postgres%402025%21@10.0.0.2:5432/termi-api_development"
cargo loco start 2>&1
```

### MCP Server

```powershell
.\start-mcp.ps1
```

Default MCP endpoint:

```text
http://127.0.0.1:5151/mcp
```

Default local development API key:

```text
termi-mcp-local-dev-key
```

The MCP server wraps real backend APIs for:

- Listing, reading, creating, updating, and deleting Markdown posts
- Listing, creating, updating, and deleting categories
- Listing, creating, updating, and deleting tags
- Reading and updating public site settings
- Rebuilding the AI index

## Repo Name

Recommended repository name: `termi-blog`