@natjswenson/devlog 0.1.3 → 0.1.4

package/README.md

@@ -1,12 +1,15 @@
 # devlog
 
+[![npm](https://img.shields.io/npm/v/@natjswenson/devlog?color=blue)](https://www.npmjs.com/package/@natjswenson/devlog)
+[![license](https://img.shields.io/npm/l/@natjswenson/devlog)](./LICENSE)
+
 A Claude Code skill that turns your daily git commits into a published dev log — and a React example for displaying it on your site.
 
 > **Build in public, automatically.** Make commits like you always do. Run `/devlog`. Today's work shows up on your site as a narrative entry, not raw commit messages.
 
 ## Live example
 
-The skill is in production at [natejswenson.io/devlog](https://natejswenson.io/devlog), publishing entries to [github.com/natejswenson/daily-dev-log](https://github.com/natejswenson/daily-dev-log).
+The skill is in production at [natejswenson.io/devlog](https://natejswenson.io/devlog), publishing entries to [github.com/natejswenson/daily-dev-log](https://github.com/natejswenson/daily-dev-log). What you see on that page is exactly what `npx @natjswenson/devlog preview` renders for you locally.
 
 ## How it works
 
@@ -159,6 +162,22 @@ See [`config.example.json`](./config.example.json) for a complete template.
 - **Tweak the UI:** override the `--devlog-*` CSS variables in `examples/react/DevLogPage.css` to match your theme. Or build your own UI against the data contract above.
 - **Add more projects:** edit `~/.claude/skills/devlog/config.json` directly.
 
+## Troubleshooting
+
+**`sh: devlog: command not found` when running `npx`:** you're probably inside a checkout of this repo. The local `package.json` collides with the published name. Run `npx` from anywhere else (e.g. `cd ~ && npx @natjswenson/devlog ...`).
+
+**Init prompt shows `78` after the placeholder text:** that's an artifact of capturing terminal output (cursor save/restore escapes); in a real terminal you won't see it.
+
+**Preview is blank / no tabs / no entries:** check the browser console. If you see *"does not provide an export named …"* errors related to `react-dom/client`, `style-to-js`, or `react-markdown`, you're on a pre-0.1.3 release — upgrade with `npm cache clean --force && rm -rf ~/.npm/_npx && npx --yes @natjswenson/devlog@latest preview`.
+
+**`npm publish` (if you fork/republish your own copy) fails with 403:** npm requires 2FA or a granular access token with bypass-2FA enabled for write operations. Easiest path: enable 2FA, install an authenticator app, and pass `--otp=<code>` to `npm publish`.
+
+**Init can't find `gh`:** install via [cli.github.com](https://cli.github.com/) and run `gh auth login`.
+
+## Versioning
+
+Stable: see [npm](https://www.npmjs.com/package/@natjswenson/devlog). The package follows semver — bug fixes in patch releases (0.1.x), behavior changes in minor (0.x.0).
+
 ## License
 
 MIT

package/SKILL.md

@@ -14,16 +14,18 @@ Usage: `/devlog` (all configured projects) or `/devlog <project-key>` (single pr
 
 This skill is configuration-driven. All user-specific values (target repo, git author, project list) live in `~/.claude/skills/devlog/config.json`.
 
-Schema:
+Schema (required fields plus optional ones):
 
 ```json
 {
   "targetRepo": "<owner>/<repo>",
+  "branch": "main",
   "gitAuthor": "Your Name",
   "githubUser": "<your-github-username>",
   "projects": [
     {
       "key": "project-key",
+      "label": "Display Name",
       "path": "/absolute/path/to/project",
       "remote": "<owner>/<repo>"
     }
@@ -31,6 +33,8 @@ Schema:
 }
 ```
 
+Optional fields: `branch` (defaults to `main`), `projects[].label` (defaults to `key`).
+
 ## Step 0: Load and validate config
 
 ```bash
@@ -144,7 +148,7 @@ git add .
 
 # Single commit covering all projects
 git commit -m "devlog: add entries for YYYY-MM-DD"
-git push origin main
+git push origin <config.branch || 'main'>
 
 # Cleanup
 rm -rf "$TMPDIR"
@@ -160,7 +164,7 @@ Dev log entries published for <Month Day, Year>
   Project: <project.key>
   Commits summarized: <count>
   Public commits linked: <count>
-  URL: https://github.com/<config.targetRepo>/blob/main/<project.key>/YYYY-MM-DD.md
+  URL: https://github.com/<config.targetRepo>/blob/<config.branch || 'main'>/<project.key>/YYYY-MM-DD.md
 ```
 
 ## Edge Cases

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@natjswenson/devlog",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Daily dev log generator — Claude Code skill + preview app for publishing git-based dev logs to your site",
   "license": "MIT",
   "author": "Nate Swenson",