minipostiz-devto-setup

# minipostiz-cli — Dev.to Setup Dev.to has a simple REST API. One API key is all you need. ## What you need | Credential | Flag | |------------|------| | API Key | `--apiKey` | | Tags (optional) | `--tags` (comma-separated, max 4) | | Series (optional) | `--series` | --- ## Step 1 — Generate an API Key 1. Go to https://dev.to → sign in 2. Click your avatar → **Settings** 3. **Extensions** → **DEV Community API Keys** 4. Enter a description (e.g. `minipostiz`) → **Generate API Key** 5. Copy the key — it's shown once (but you can generate multiple) --- ## Step 2 — Store in minipostiz-cli ```bash minipostiz auth --platform devto --apiKey "YOUR_API_KEY" # With optional defaults minipostiz auth --platform devto \ --apiKey "YOUR_API_KEY" \ --tags "webdev,productivity,tools" \ --series "My Series Name" # Or via supercli sc minipostiz auth set-devto --apiKey "YOUR_API_KEY" ``` --- ## Step 3 — Test ```bash minipostiz auth verify --platform devto minipostiz publish --platform devto --message "# My First Post This is the body of the article published via minipostiz-cli." ``` --- ## Post format Dev.to posts are **articles**. minipostiz-cli maps: - **First line** of `--message` → article title (markdown heading stripped) - **Remaining lines** → article body (markdown supported) ```bash minipostiz publish --platform devto --message "# Article Title ## Introduction Body content here. Supports **bold**, *italic*, \`code\`, etc." ``` --- ## Optional: tags and series Tags and series can be set at auth time (applied to all posts) or overridden: ```bash # Update auth to set default tags minipostiz auth --platform devto --apiKey "KEY" --tags "javascript,node,cli" ``` --- ## Troubleshooting | Error | Cause | Fix | |-------|-------|-----| | `401 Unauthorized` | Invalid API key | Regenerate key at dev.to → Settings → Extensions | | `422 Unprocessable` | Article validation failed | Ensure title (first line) is non-empty | | Post published but no tags | Tags not in auth | Add `--tags` to `minipostiz auth --platform devto` | ## Token lifetime Dev.to API keys **do not expire** unless deleted from Settings → Extensions.