Visual guide v2 · 20 October 2026

A description that feels like your story.

Choose a theme. Write your scene. Make it yours. This illustrated companion takes you from an empty builder to a reusable, ready-to-copy description.

Community 0.4.2 · Personal Lab 2.2.2 · works offline

► Open Community Builder

01 / Find your starting point

What are you making today?

The interface diagrams are simplified illustrations based on the current source—not screenshots. The theme artwork is the real bundled pack artwork. The previous toolkit was tested by the creator; the new mode/gallery interface still needs hands-on desktop and phone review.

02 / Know your workspace

A map of the tool

Illustrated builder with six numbered callouts: mode switch, templates, theme gallery, identity, writing, and preview/copy/export checks.
Numbered callouts identify the main parts. On narrow screens the preview moves beneath the editor. Scroll inside the illustration on smaller screens.
  1. 1 · Simple / Advanced
    Change which controls are visible. Your writing and settings stay intact.
  2. 2 · Start or reuse
    Use a starter layout or Load my template. Save the current draft before replacing it.
  3. 3 · Set the mood
    Pick a theme tile, adjust artwork toggles, and browse its headers, dividers, buttons and banners.
  4. 4 · Bot identity
    Title, tagline, POV, relationship and tone. Advanced adds series, status and other details.
  5. 5 · Writing
    Open sections, include or omit them, and use Edit visually. Add a section reveals more in Simple.
  6. 6 · Preview and take it with you
    Use Design, Export preview, HTML and Narrow. Check export notices, Copy HTML and Save draft JSON.
Also in Advanced: section move/duplicate controls, optional blocks, import/private notes, template creation, custom design editing, and the copy/paste marker tabs. The changelog and feature-status guide explain what is available and what is still planned.
03 / Choose your pace

Simple and Advanced share the same description.

SimpleAdvanced adds
Starter layouts and Load my templateSave as template, with public wording and design options
Visual theme gallery, graphic browser and artwork switchesCustomize design, Import design and Export design
Title, tagline, POV, relationship and toneInternal project name, series, status and metadata controls
Warnings, scenario, intros and author notes; Add a section for moreHeading/divider choices, move/duplicate controls and optional blocks
Compact visual formatting; preview, copy and draft filesText color/size, character-card import, private notes and marker tabs

Community starts in Simple. Personal Lab starts in Advanced and keeps your personal designs. Each edition remembers its mode separately in this browser. The Community theme showcase below contains five premade packs; Personal Lab does not bundle them.

Safe to switch: hiding a control never clears its setting. An advanced draft keeps its formatting and optional blocks in Simple, and a notice names the additional enabled sections. Use Add a section or Advanced to edit more.

Community/Beta/Experimental/Planned labels describe feature availability and stage. They do not mean a website was published or every combination was verified.

04 / Five complete creative directions

Choose a theme—not just a color.

Click a tile under Set the mood. It applies the pack’s header and divider artwork and opens Design preview. Your writing and explicit text formatting stay in place. Turn the optional banner on when you want one.

Cyber // Green Signal

Angular signals, electric greens and circuit details.

#3C1642#086375#1DD3B0#AFFC41#B2FF9E
Actual Scenario header from Cyber // Green Signal

Your story. Its own atmosphere.

Kawaii / Cloud Nine

Pastel stickers, hearts, clouds and playful lettering.

#FFADAD#FFD6A5#FDFFB6#CAFFBF#9BF6FF#A0C4FF#BDB2FF
Actual Scenario header from Kawaii / Cloud Nine

Your story. Its own atmosphere.

Gothic / Velvet Nocturne

Blackletter, wine tones, thorns and cathedral details.

#191528#3C162F#5C162E#7C162E#110E1B
Actual Scenario header from Gothic / Velvet Nocturne

Your story. Its own atmosphere.

Clean UI / Arctic Glass

Mint glass, glossy capsules and early-digital calm.

#333333#48E5C2#FCFAF9
Actual Scenario header from Clean UI / Arctic Glass

Your story. Its own atmosphere.

Night Mode / Quiet Hours

Berry ink, celestial accents and quiet decorative lettering.

#191D32#282F44#453A49#6D3B47
Actual Scenario header from Night Mode / Quiet Hours

Your story. Its own atmosphere.

Decorative lettering lives in the header images. Changing a section’s fallback title does not rewrite the lettering in that image. Use a different graphic or choose a text heading in Advanced. Choosing a theme does not erase explicitly colored or sized writing.

05 / Walkthrough A

Make a quick description.

  1. Start in Simple.

    Open the builder and choose Simple. Use New blank, or select a starter layout and choose Use starter layout. Confirm replacement only after saving anything you want to keep.

  2. Click a theme tile.

    Pick Green Signal, Cloud Nine, Velvet Nocturne, Arctic Glass or Quiet Hours. The selected tile gets a highlighted border. Selecting it also restores artwork if an older saved draft had graphics disabled.

  3. Fill in the identity.

    Add the display title and one-sentence tagline. Choose POV, starting relationship and up to three tone tags. Leave anything you do not want to display unspecified.

  4. Write the public description.

    Open Content Warnings, Scenario, Intro Options and Author Notes. A short scenario explains the setup. Use Include section in output to omit a section; empty optional writing is generally skipped.

  5. Format a few words.

    Choose Edit visually, select a phrase, and use bold or another control. Choose Apply changes to update that field. Cancel leaves the original field unchanged.

  6. Preview, copy and keep a draft.

    Use Design to inspect the theme and Narrow for the smaller layout. Then check Export preview and any notices. Choose Copy HTML, and Save draft JSON so you can edit this bot later.

You are done when: the writing reads correctly, included sections are intentional, Export preview is acceptable, and you have a downloaded editable draft.
Walkthrough B / Several openings

Offer multiple intro choices.

  1. Open Intro Options.

    Add a short section note if useful, then choose + Add intro for each option. Community begins with one blank custom option; Personal Lab can have its own starting arrangement.

  2. Label and summarize each variant.

    Choose Neutral, Feminine, Masculine or Custom, add pronouns or a label, and write a Brief intro summary. Add an Optional excerpt only when you want that text publicly displayed.

  3. Keep summaries separate from first messages.

    These are description entries. The builder does not install or change the bot’s actual first messages. Only variants with a summary or excerpt appear in the generated description.

  4. Review the sequence.

    Use the preview to check the labels and summaries. Advanced offers the intro count and separator controls; it also lets you duplicate an entire section for a separate grouping.

Example labels: Arrival · AnyPOV; Reunion · AnyPOV; Alternate opening. Choose labels that accurately match your bot—no requirement to invent three variants.
06 / Text that stays editable

Use the visual editor.

Illustration showing selected words, the formatting toolbar, Apply changes and three steps: select, format, apply then save.
Select existing words for inline formatting. Lists and alignment work on paragraphs, including at the caret. Scroll inside the illustration on smaller screens.

Everyday formatting

Simple exposes bold, italic, underline, strikethrough, links, lists, alignment, clear formatting and undo/redo. Advanced also exposes text colors, theme swatches and size choices.

Use a full HTTP/HTTPS link. Pasting adds plain text; clipboard HTML or outside formatting is not imported. Drop content is not supported.

Keep the result

Apply changes updates the field. Save draft JSON keeps the whole description for another session. A template also retains formatting when public wording is enabled.

Editing the original plain-text field clears that field’s saved visual formatting. Use Edit visually again when you want to preserve styles while changing the writing.

Inline formatting needs selected words; preselecting a style for future typing at an empty caret is not provided. Lists are flat, with no nested indentation. Available sizes: 12, 14, 16, 20, 28 and 36 pixels. Ctrl/Cmd+B, I and U format a selection; undo/redo are available in the editor. Janitor may adjust or ignore styles.

Walkthrough C / Reuse your setup

Make your own local template.

Illustrated template dialog with public wording off and selected design on, plus panels explaining privacy and sharing.
The two checkboxes control reusable public content and design. Private notes and internal project name are always excluded. Scroll inside the illustration on smaller screens.
  1. Arrange the reusable layout in Advanced.

    Move or duplicate sections, choose headings/dividers, and add optional blocks as needed. Layout-only templates keep section titles and intro labels, so make those generic if you will share the file.

  2. Choose Save as template.

    Give it a useful name and optional description. Leave Include current public text and links off for a blank reusable layout; turn it on for standard author notes, credits or other reusable public wording.

  3. Choose whether the design travels.

    Include my selected design carries its graphics, image URLs and reusable notice defaults. Turn it off when you want the receiving draft to keep its current design.

  4. Download and reload later.

    Download template and keep the file. Use Load my template in either mode, confirm replacing the current description, fill in the next bot, and Save draft JSON.

Templates are local files. They are not an account library or a cloud sync service. Public wording includes text in hidden sections. A layout-only template can still contain identifying section labels, artwork or design defaults—review it before sharing.
Walkthrough D / Your own creative direction

Customize colors, headers and graphics.

  1. Start with a theme you like.

    Choose a tile first. Switch to Advanced and use Export design if you want a separate backup before editing. Customize design edits the active design; it does not save a separate named catalogue automatically.

  2. Open Customize design.

    Edit the pack name, colors, symbols, divider wording and reusable notices. Changing colors affects the design; it does not erase explicit text colors saved with the visual editor.

  3. Add or replace the artwork.

    Choose a PNG, JPEG or WebP up to 3 MB, add meaningful alternative text, and set the graphic role. Keep existing asset keys when replacing a graphic so existing section selections continue to find it. New asset keys are selected separately in section or optional-block controls.

  4. Apply and choose where it appears.

    Apply design, then review section heading/divider choices. Advanced → Optional extra blocks supports text, quotes, bullets, music, links and images. Image blocks can use a pack graphic or a hosted URL, with an optional click destination.

  5. Save both the design and the writing.

    Export design downloads styling and artwork without bot writing or scratchpad. Save draft JSON keeps the complete current bot. See the hosting walkthrough before relying on artwork in copied HTML.

Supported image imports are PNG/JPEG/WebP; SVG, raw HTML and font files are not accepted. Decorative font lettering can be supplied as header images. A banner uses the banner asset key. The builder actively edits one selected pack at a time.

Walkthrough E / Work from an existing character

Import a card, then write the public version.

  1. Save your open work first.

    Download a draft before importing. Card import replaces the current description after confirmation.

  2. Use Advanced → Import & source notes.

    Choose Import Janitor / Datacat JSON and select a supported character-card JSON file. The card input limit is 2 MB. This is different from Open draft or Load my template.

  3. Review the imported details.

    Check title, scenario, warnings, POV and intro options. Do not assume the imported labels or inferred metadata are correct for your final public description.

  4. Write your own public intro summaries.

    Full source greetings and creator notes are kept in the private scratchpad for reference. They are not silently copied into the public intro summaries. Choose what short summaries or excerpts you actually want visible.

  5. Preview and save.

    Check Export preview and keep a new draft. Private notes are excluded from copied HTML and templates, but are intentionally included in editable draft files.

07 / Design → hosted output

Why the two previews can differ.

Three-step illustration: local artwork in Design, a direct hosted image URL in the graphic library, and the actual Export preview with safe fallback text.
Local image previews do not automatically become hosted images. Export preview is the check for what copies. Scroll inside the illustration on smaller screens.
  1. Browse the selected pack’s graphics.

    Expand Browse theme headers, dividers, buttons & banners under Set the mood. Choose the category. Local bundled graphics have a Download local image button; hosted-only graphics can be opened.

  2. Get a direct hosted image URL.

    Download the art, upload it to an image host or supported destination image workflow, then obtain the direct image address. The builder does not upload or host files for you. Use HTTP/HTTPS and review your host’s permissions.

  3. Paste the URL into the matching asset.

    Set Hosted image URL for that graphic. A new local preview upload clears the old hosted URL, so add the new image’s URL before copying.

  4. Check Export preview.

    Review every selected header, divider, banner and standalone image. Without hosted URLs, headings/dividers use text fallbacks; banners and standalone images are omitted. Read Before you export notices and test the final destination.

08 / Keep the right file

Draft, template, design—or finished HTML?

UseSave withOpen withWhat it contains
Continue this exact botSave draft JSONOpen draftWriting, formatting, layout, selected design and private notes
Reuse a layout or standard wordingAdvanced → Save as templateLoad my templateStructure; optional public text and selected design; never scratchpad/internal name
Reuse a visual designAdvanced → Export designAdvanced → Import designColors, notices, graphics and image URLs; no bot writing or private notes
Take the finished description to JanitorCopy HTML or Download .txtDestination’s verified HTML workflowGenerated public description only; not an editable builder draft
Inspect a browser renderingDownload .htmlYour browserA preview document; use Copy HTML for the description fragment

Autosave helps; downloaded drafts travel. Browser autosave can fail because of origin, file location or quota restrictions. Moving or renaming the HTML file may change access to saved browser data. Turning autosave off does not erase earlier copies. Keep downloaded backups before upgrades and imports.

Compatibility with older files

Current drafts use version 3; current templates use schema 2. Both editions accept older Community draft schemas 1/2 and supported Personal Lab drafts/templates. Older builders cannot open the newer formats. A converted Community draft keeps a normalized legacy source archive to preserve unused legacy settings/packs; review the converted layout. That archive never enters template exports.

09 / Janitor handoff

Finish the description. Then verify it on Janitor.

The detailed Janitor screen-by-screen tutorial is waiting for owner-confirmed references. This guide does not guess the current editing screens or claim that every style is supported. The class-based box/button picker is also planned, not available yet.
  1. Save the editable work.

    Save draft JSON, and export any custom design you want to keep separately.

  2. Prepare the public HTML.

    Check Export preview, read the notices, and Copy HTML. Do not paste draft/template/design JSON into a bot description.

  3. Use the owner-confirmed destination workflow.

    The project owner will provide the correct editing screen, description field/HTML mode, image-hosting procedure, save controls and final preview steps. These will become an annotated walkthrough.

  4. Review the final destination.

    Once pasted through the verified workflow, check desktop/phone layout, every image and link, warning readability, section order and formatting before publishing.

The owner reports successful testing of the earlier toolkit. That is useful feedback, not certification of every pack, style, host or layout. Site behavior can differ from the builder preview.

10 / Quick fixes

If something looks wrong

I only see a dropdown or colors, not the theme gallery.

Check the edition/version in the header. Use Community 0.4.2 for the five-tile gallery. Personal Lab has your personal designs instead. If you opened an older saved draft with artwork disabled, click a tile to reapply the full pack and choose Design preview.

The art appears in Design but disappears when I copy.

Add direct hosted image URLs in the graphic browser, then check Export preview. This is expected for local preview images; the builder does not host them automatically.

The header image still says “Scenario” after I rename the section.

The lettering is inside the image. In Advanced choose another heading graphic, a text heading, or replace the asset with your own image. The title field supplies the text fallback.

My advanced settings seem to be missing in Simple.

They are still active. Read the retained-settings notice. Use Add a section or switch to Advanced to edit them; a mode switch never resets the draft.

A text edit removed my visual formatting.

Editing the original textarea intentionally clears that field’s saved formatting. Use Edit visually for future wording changes that should preserve styles, then Apply changes.

I clicked Bold and nothing happened.

Select existing words first. Inline formatting requires a selection; lists and paragraph alignment work at a caret. Apply changes commits the editing session.

How do I get the HTML if clipboard access is blocked?

Use the HTML tab, Select code, then your device’s copy command. You can also Download .txt and copy its contents.

I lost my draft after moving the tool file.

Open your downloaded draft with Open draft. Browser autosave can depend on the file’s origin/location. Keep downloaded backups; autosave is not cloud sync.

Why are imported intro summaries blank?

The builder keeps full greetings privately and asks you to write the short public summaries. This avoids publishing a full first message unintentionally.

Which file button should I use?

Draft → Open draft. Template → Load my template. Design pack → Import design in Advanced. Character card → Import Janitor / Datacat JSON in Advanced. Raw HTML, SVG, font files and early design-review manifests are not production import files.

Can I safely share a layout-only template?

Review it first. Writing and its visual formatting are removed, but section labels, policy choices, notice defaults and an included design may still identify you. Personal templates can contain private artwork URLs or destinations in the design.

Where are the decorative symbols and Janitor-style boxes?

The copy/paste marker tabs already exist in Advanced. The full kaomoji/deco library and Janitor class-based box/button picker are separate planned work; they are not installed by this guide.