Skip to main content

Quick Start

This guide walks through writing, previewing, and sending your first post from an existing repository.

Before you start​

  • The desktop app is installed and you are signed in
  • At least one repository is added to the app
  • The repo has been initialised with npx @postlane/cli init (or you have a .postlane/ directory already)

1. Open the Drafts view​

Select a repository from the left sidebar. The Drafts tab shows posts that Postlane has generated from recent commits.

If no drafts appear, make sure the repo has recent commits and the watcher is active (a dot in the repo row indicates it is watching for changes).

2. Review a draft​

Click a draft to open the post editor. You will see:

  • The generated text alongside a preview for each platform
  • Character counts and any platform-specific warnings
  • The source commit that generated it

From here you can:

  • Edit the text directly -- click into any platform's text area and type. Changes save automatically.
  • Customise per platform -- each channel (LinkedIn, X, Bluesky, etc.) has its own version of the post. Adjust tone, length, and hashtags independently for each audience.
  • Add or change images -- attach an image from your machine, or search Unsplash and other royalty-free sources directly from the editor.

3. Approve and send​

Click Approve to mark the post as ready. If you have a scheduling provider connected, you can queue it for a specific time. Otherwise, click Send now.

4. Check Published​

Switch to the Published tab to see what has gone out and when.

Next steps​

  • Scheduling — connect a provider and automate timing
  • Analytics — track engagement after posts go live