Frequently asked questions
Everything you need to know before you start writing in Bookshaper.
Features and workflow
- How is Bookshaper different from Scrivener or Google Docs?
- Scrivener is great for organizing a manuscript, and Google Docs is great for writing prose—but neither gives you insight into your story’s structure, pacing, or character arcs. Bookshaper combines a focused writing environment, structural organization tools (card view, outline, drag-and-drop), AI-powered narrative analysis, character and continuity tracking, interactive dashboards, and publication-ready export—all in a single app.
- What can the AI actually tell me about my manuscript?
- You get a prioritized report card that highlights what’s working and what needs attention, with specific guidance for each finding. Under the hood, it analyzes structure, character arcs, pacing, themes, emotional cadence, continuity, and voice consistency. It also tracks what changed between analysis runs so you can see whether your revisions are moving things in the right direction. Every finding is something you can act on or ignore—nothing is changed without your say-so.
- What is AI Chat?
- AI Chat is a conversational panel you can open alongside any view in Bookshaper. It knows your manuscript’s structure, characters, and analysis results, so you can ask follow-up questions about your story, brainstorm plot ideas, get craft advice specific to your scenes, or ask how to use a feature in the app. Each conversation is saved with your project so you can pick up where you left off. AI Chat costs 1 credit per message in platform mode, or uses your own API key at the provider’s rates.
- Does the AI write or generate text for me?
- Bookshaper’s AI starts with analysis—it examines your writing and shows you what’s working and what might need attention. Beyond analysis, it offers targeted editing tools: scene rewrite, line edit, expansion, and dialogue harmonization. Every proposed change appears in a diff view so you can review, accept, or reject it individually. The marketing blurb generator creates back-cover copy and taglines, and Cover Studio lets you design front covers, back covers, and spines—starting from AI-generated concepts or your own artwork. Nothing is ever applied without your explicit approval.
- What are the AI rewrite and editing tools?
- Scene rewrite refines your prose across six dimensions (voice, tone, diction, syntax, figurative language, structural style) while preserving meaning. Line edit offers sentence-level clarity and rhythm improvements. Expansion develops thin passages with beat-level annotations. Dialogue harmonization ensures consistent character voices across chapters. Every change is shown in a side-by-side diff view with full undo/redo history.
- What are style profiles and drift detection?
- A style profile (ESP) captures your writing’s voice signature—its characteristic patterns of diction, syntax, and tone. Once generated, drift detection compares new writing against your profile and flags when your prose diverges from your established voice. You can freeze a profile to lock it in, or refresh it as your style evolves.
- What are the visual dashboards?
- Interactive charts that provide the evidence behind every coaching finding. They show word count distribution, chapter balance, POV patterns, dialogue-to-narration ratios, tension plots, pacing heatmaps, and a timeline view. You can click any chart element to jump directly to that scene or chapter.
- Can I customize how my book looks when I export it?
- Yes. The style editor gives you control over typography, spacing, margins, running headers, ornamental decorations, hyperlink appearance, and more—across dozens of style targets. You can preview in real time for both print and ebook formats before exporting to EPUB, PDF, or DOCX.
- How do I sign in to Bookshaper?
- You can sign in with email and password or use any of the supported social logins: Google, Microsoft, Facebook, Apple, LinkedIn, or X. Social login uses your existing account with that provider—no extra password to remember.
AI credits and usage
- What are AI credits?
- AI credits meter Bookshaper’s AI features. Scene, chapter, and character analyses cost 1–3 credits each (1 per scene, 2 per character, 3 per chapter). Consistency checks, dialogue analysis, and style operations cost 1–3 credits per run; AI Chat costs 1 credit per message. Rewrite, line edit, expansion, proofread, and narration scale with how much text you send — a small selection costs a fraction of a credit, a full scene typically runs 2–5. Pro subscribers receive 1,000 credits each month, reset at the start of each billing cycle. Credits are only charged on successful completion.
- How many credits does a full manuscript analysis use?
- It depends on manuscript size. A standard novel (around 60,000–80,000 words) typically uses 135–175 credits for a complete analysis pass covering all scenes, chapters, and characters. A longer novel (100,000+ words) may use 230–340 credits. Your monthly Pro allowance of 1,000 credits is designed to cover multiple full passes with room for selective re-analysis after revisions.
- What happens when I run out of credits?
- You can purchase credit packs to continue analyzing. Packs come in three sizes: 500 credits for $12.99, 750 credits for $16.99, and 1,000 credits for $19.99. Pack credits are added to your balance immediately and don’t expire at the end of your billing cycle.
- Can I use my own API key instead of credits?
- Yes. Bookshaper supports Bring Your Own Key (BYOK) mode for Anthropic (Claude), OpenAI (GPT), Google (Gemini), Mistral, Groq, OpenRouter, and Together.ai. OpenRouter and Together.ai also let you choose from hundreds of open-source and frontier models — including Llama, DeepSeek, Qwen, and Mixtral — with a single API key. In BYOK mode, analysis requests go directly to the provider using your API key, and you pay the provider at their rates. No Bookshaper credits are used. You can switch between platform and BYOK mode at any time in Settings.
- Do trial users get AI credits?
- Yes. The free trial includes 75 AI credits — enough to analyze a few chapters and experience the narrative coaching workflow before subscribing.
- Am I charged credits if an analysis fails?
- No. Credits are only consumed when an analysis completes successfully. If something goes wrong — a timeout, a network issue, or an unexpected response — no credits are deducted.
Data, privacy, and backup
- Where is my manuscript stored?
- Locally on your device as plain Markdown and JSON files. When cloud sync is enabled, an encrypted copy is also stored in the cloud. Your manuscripts are encrypted on your device before upload using AES-256 encryption—the server never sees your words.
- What is cloud sync?
- Cloud sync automatically backs up your project to the cloud after each save. Your manuscript is encrypted on your device before it leaves—the server stores only the encrypted archive and has no access to plaintext content. If your computer is lost, damaged, or replaced, sign in on a new device and your projects are waiting for you. Cloud sync is available on all subscription tiers and can be toggled on or off per project in Project Settings.
- How do I restore my project if my computer is lost or damaged?
- You have two recovery options. From the cloud: open Bookshaper on any device, sign in, and go to File > Cloud Projects to download your synced projects. From a local backup: use File > Restore from Archive to open a ZIP backup from your backup folder. Both methods restore the full project including chapters, characters, locations, notebook entries, and settings.
- Does Bookshaper automatically back up my work?
- Yes, in two ways. Auto-backup creates timestamped ZIP archives of your project every 30 minutes to a local folder (configurable in Project Settings). Cloud sync uploads an encrypted copy after each save. Both are enabled by default so your work is protected from the moment you start writing.
- Does Bookshaper share my data with third parties?
- Manuscript content is never shared with third parties. Cloud-synced archives are encrypted on your device before upload—not even Bookshaper’s servers can read them. Billing is handled by Stripe. Anonymized usage telemetry may be collected to improve the product, subject to your consent.
- Can I delete my data?
- Yes. Your manuscripts live on your device, so you control them directly. Cloud-synced archives can be deleted from File > Cloud Projects or by disabling cloud sync. Deleting your Bookshaper account removes your account data and any cloud archives from our servers. Your local manuscript files are unaffected.