2. Tools
2.1 Making a tool with your AI: Add a tool
My Workshop → Add → New tool, or the Add a tool page. Three moments: describe the tool for your AI, paste its whole answer once, check and create.
- Start with your AI. Describe Your idea (who it is for, what goes in, what comes out). Blackslate turns it into The prompt to send to your AI, which already contains everything Blackslate needs (one HTML file, no network, saving data with
window.leavenit, a separate square icon, and a summary block). Copy prompt, paste it into Claude, ChatGPT or Gemini, and come back when the tool works. Or open it directly: Claude, ChatGPT and Le Chat open with the prompt already filled in (ChatGPT sends it right away; Le Chat only when the prompt is short enough), and Gemini opens ready for you to paste; each button also copies the prompt, in case your AI opens without it. Already have a tool? I already have my tool. Then Does your tool need tables?- No, the tool keeps its own data (default): settings, lists, notes, saved automatically for each person who uses it. Best for tools you share or publish.
- Yes, tables: rows you add, edit or import from a spreadsheet, kept in a folder and shared with its members. Choose Where will it live? (My Workshop, a shared folder, or a folder with separate data). + New folder makes one on the spot: inside an existing place (the tool and its tables are then put together in it), or A new shared folder that you can share with others afterwards. Do you already have data? (optional): attach your CSV files. They are only read on your device, to show your AI their columns and a few rows; nothing is imported yet.
Your AI designs the tables: the prompt asks it to decide how many tables the tool needs and their columns (an
idcolumn in each), to keep your files' columns, and to end its answer with a table plan:
LEAVENIT TABLES recipes: id, name, servings, steps | file recettes.csv recipe_ingredients: id, recipe_id, ingredient_id, grams END - Paste your AI's answer. In your AI, copy its whole answer with the message's Copy button, then paste it in Blackslate's box (or Paste from the clipboard). Blackslate takes every piece from it at once: the tool's code, the table plan (
LEAVENIT TABLES), theTitle:,Description:,Category:andPrompt:lines, and the icon (SVG). Two cases are explained on the spot:- The code was put apart: Claude's artifacts and ChatGPT's canvas aren't copied with the message. Open it, copy it, and paste it here: the rest is already loaded.
- The answer is cut off before the end of the code (too long for one message): ask your AI to "continue", then paste the rest; Blackslate joins the two.
Have the tool as a file? I have the tool as a file (.html): Upload a file (
.html, up to 2 MB) or paste only the code.
- Check and create: one screen, already filled from the answer.
- The name and the description, to correct right there; Who can see it: Private (only you, by default), By link (anyone with the link), Showcase (everyone, after review).
- The category, the icon and the code: Change opens the detailed screens (screenshots, your own icon or Paste SVG code, Paste the block from your AI…). Without an icon in the answer, Blackslate makes one from the title.
- For a tool with tables, what happens to each table in its folder: will be created, will be imported from an attached file (adding the
idcolumn, or empty columns the file doesn't have), or already there, used as is. A table that can't be set up (a protected table when you aren't a manager of the folder, a file that isn't attached) is shown in red, with what to do, and Create waits. No table plan in the answer: Blackslate opens Set up the tables, to paste it or set them up yourself. - Try it opens the tool in full screen before creating it, without your data: nothing is saved.
- Create makes the tables, the tool and its app icons in one go. "Your tool is ready", or "Sent for review" for the Showcase: you can already use it while it waits. A tool with tables is added to its folder automatically: Open it in … opens it with its tables. Publishing it on the Showcase shows a warning, since other people won't have these tables.
The prompt also tells your AI how to present its answer: everything in the message itself (never in an artifact or a canvas), each piece in its own code block under a fixed heading: "1. The tool", then "The tables" (tools with tables), "The details" and "The icon". That is what lets Blackslate read them all from one paste.
A tool always works on Blackslate: React code (.jsx, .tsx) doesn't run here, so it is refused, with what to ask your AI instead (a single self-contained HTML file).
2.2 The tool page
Actions: Open (full screen), Install, Copy (make a copy: your own version, with its files), Edit (makers), Share, ☆ Add to favorites, More → Report.
On the page: About this tool and Copied from (which tool it was copied from, and its copies on the Showcase), then the tool itself, to use right there.
Where your data goes: a tool opened from My tools or My Workshop saves your personal data. Opened from a shared folder, it can also use that folder's shared data (the tool page shows Open in to choose).
Installing a tool as an app (Install): the tool gets its own icon and window, on its own address (apps.leavenit.com), so it can be installed whether the Blackslate app is installed or not. The first time, the tool asks you to sign in on that address, once per device (on iPhone and iPad, an installed app always has its own sign-in). Notifications keep coming from Blackslate.
Without a connection: a tool you've opened on a device (signed in, in the last 30 days) opens again on it without a connection, from its address or its icon on the home screen, with the data it last showed. A banner says it's offline and since when; your changes are kept on the device and sent when the connection is back (the ⋯ menu shows how many are waiting). Tables and files work too: tables and photos the tool already opened on that device, and new photos, sent when the connection is back. The inbox, e-mails and calendars need a connection. Settings → Keep my tools available offline turns it off for a device; signing out erases what the device kept.
2.3 Publishing and sharing
- Share → Who can see it: Private, By link, Showcase. Copy link, Share with a person.
- Showcase means a short review first. A change to a published tool sends it back to review ("Any change sends your tool back to review.").
- In a shared folder: Workshop → open the folder → Add → Shortcut to one of my tools…, or from My Workshop, the tool's ⋯ → Create shortcut in…. It stays one tool: a change shows everywhere, and each folder keeps its own data.
- On the tool page, the Folders sheet ("Where should it live?") lists where the tool is published.
2.4 Makers: editing a tool together
Edit tool → Makers and publishing (at the top):
- Makers (up to 10, invitations included) can edit the tool, publish it and invite others. All makers are equal. Add a maker shows people who share a folder with you → Invite. The person accepts from the notification bell (the invitation expires after 7 days).
- Leave (if you're not the last maker), Remove a maker, Cancel invitation.
- Publishing is independent from makers: Just the makers (always on), By link, Showcase (with its review state: Approved, Pending review, Not accepted).
2.5 Editing, history, conflicts
- Edit opens Edit tool: replace the file, the screenshots, the icon, the texts → Update.
- Change it with your AI (at the top of Edit tool), in two steps. 1. Describe the change, then choose where to ask. In the conversation where you made it (the default, and the best: your AI already knows the tool): Copy the message copies your change and how to answer, to paste in that conversation. In a new conversation, if you don't have it any more: Blackslate writes a change prompt that holds everything your AI needs: the tool's current code, its tables, its title and description, your change, and how to answer (only the pieces that change, all in the message; for the code, change blocks rather than the whole file). Start a new conversation with it: no need to find the one where you made the tool. Copy prompt, or Claude, ChatGPT, Le Chat, Gemini: each copies the prompt and opens your AI, ready to paste (it is usually too long to be filled in by itself). A big tool (over about 150 KB of code): its code goes as a file, Download the tool file and attach it to your message. The choice is remembered on the device. 2. Paste your AI's answer in the box (or Paste from the clipboard): Blackslate puts each piece in its place: the new code, the title, description and category, the icon, and the new table plan. It lists what changes (Changes from your AI's answer) and marks the fields concerned from your AI; pieces the AI didn't give again stay as they are. Nothing is saved before Save these changes, the icon included; Try it opens the new version first, without your data; Undo puts the form back as it was. The new tables and columns are applied when saving (if one can't be done, it is shown in red and saving waits). Change blocks: for the code, your AI usually gives only what changes, as blocks:
<<<<<<< FIND, lines copied from the current code,=======, the new lines,>>>>>>> REPLACE. Blackslate puts them in the current code, in order and all or none: as written, or else line by line, whatever the spaces. If one doesn't find its place (your AI worked on an older version, or copied a line wrong), nothing is changed, and Blackslate offers a ready message holding the current code, asking your AI for the whole file. The whole file is accepted too. If your AI gives a piece of code without its FIND part (a function to replace), Blackslate says so: ask it for the whole file again. The same help as in Add a tool if the code was put apart (artifact, canvas) or the answer is cut off. - Edit is also in the ⋯ menu of the open tool and in a tool's menu in My Workshop, for the people who make it.
- Tables (on Edit tool): when your AI changes the tool's tables (a new table, a new column), it gives the whole LEAVENIT TABLES block again. Change it with your AI hands it here by itself; you can also paste it there directly: Blackslate shows what changes (new table, new columns, unchanged) in the tool's home folder → Apply these changes, then update the tool with its new code. New columns are added empty: your rows are kept, in a new version of the table. Nothing is ever deleted: a table or column the plan no longer uses is only reported. In other folders where the tool is a shortcut, the tool shows what is missing, with Create them here.
- History (at the top of Edit tool): the last 10 versions, with who and what changed. Preview opens an old version (nothing is saved); Restore brings it back as a new version.
- A tool that lives in a shared folder using Dev (chapter 4.11) has three versions: a change goes to Dev first; everyone keeps the Prod version until it is promoted (Promote…). The history shows which version is in Dev, Test and Prod.
- If another maker saved while you were editing, your save is refused instead of overwriting theirs: "
saved this tool while you were editing." → Copy my description, then Reload.
2.6 Deleting a tool
Edit tool → Delete. With other makers, the tool goes to Recently deleted for 30 days and any maker can restore it. Copies taken by others are never affected.
2.7 Favorites and My tools
☆ Add to favorites on a tool page, or ⋯ → Add to favorites in Workshop: the tool joins My tools, on the last page you opened. Up to 200 favorites.
My tools is your home: tiles of Blackslate tools, but also websites and apps of the phone, on pages you name, in folders and groups. The same on all your devices.
- (+) (bottom left) adds to the page open: A tool (one of yours, or Make a new tool), A website (its address: Blackslate's server reads its name and icon once, never your device), An app of the phone (WhatsApp, Microsoft Teams, Outlook, Gmail, Google Drive, Google Maps, Slack, Notion, Zoom, Spotify, or its own link like
whatsapp://), A folder, A group, A page. - A website opens in a new tab. An app opens if it is installed on the phone, otherwise its website does: a web page can't see the apps installed nor read their icons, so the icon is the app's website's (or a letter; Choose an image to put your own).
- A folder is one tile: a tap opens it. A group is a bubble with a name: its tiles stay side by side and each opens in one tap.
- Pages: the name of the page is at the top, with the names of the page before and the page after on each side (tap one to go there). Swipe the page (phone, trackpad), turn the mouse wheel (when the page doesn't scroll itself), or use the keyboard's ← and → to go from one page to the next.
- Wallpaper: Arrange → Wallpaper, or right click (long press) on an empty spot of the page → Wallpaper…: None, a ready-made one (Dawn, Sea, Forest, Dusk, Sand, Night, Mint, Coral), or Choose an image (a photo of yours, made lighter on your device first). It is yours alone, the same on all your devices.
- Search (the bar at the bottom, between (+) and (?)) looks in every page, folders and groups included. The button at its left opens the Filters: All, Tools, Websites, Apps; and for tools All, Made by me, one per shared folder (a tool opened from a shared folder's filter uses that folder's data).
- Right click or long press on a tile: Open, Details and Edit (a tool), Edit… (a website, an app: name, address, icon), Move to page…, Arrange, Unpin (a tool: it stays in Blackslate) or Remove.
- Right click or long press on an empty spot of the page: Arrange, New page, Wallpaper….
- Arrange: drag a tile to move it; onto another tile to make a folder; into a group; to the edge of the screen to go to the page before or after. − removes a tile (undoing a folder or a group keeps its tiles on the page). Tap the page's name to rename it; Delete page sends its tiles to the page before. Done when finished.
- If two devices change your pages at the same moment, the second is told and shows them again.
- A work account (organisation) finds the organisation's pages first, arranged by its admins, then its own pages, without tools (chapter 3.8).
2.8 What a tool needs
Some tools do more with a little setup. Blackslate reads it in the tool's code:
- E-mails (
window.leavenit.mail.send): a Runner with a mail account, in the folder where the tool is used (chapter 7.9). - Reminders with the screen off (
window.leavenit.alert.at): notifications on, on each device (Settings → Notifications on this device).
It is said in Add a tool before creating it, in Edit tool when a change adds one (Changes from your AI's answer), on the tool's page before copying it (Works best with a little setup), and above the open tool while something is missing. There, the folder's owner gets Set it up: a step-by-step guide (where the Runner runs, the machine, the mail account, the commands, a test e-mail), with Ask my AI for help at each step (chapter 7.3); another member who can edit is told whom to ask; read-only members and visitors see nothing. For reminders, Turn on opens the notification settings over the tool. Not now hides it on this device for a week. Nothing is blocked: a tool made with Blackslate's prompt offers a prepared e-mail until a Runner sends them.
When the tool itself finds something missing (an e-mail that can't leave because the folder has no Runner, a reminder set while notifications are off on all the person's devices, a folder full of data), Blackslate says so right away, even after Not now. For a full folder, its owner gets Set it up: the step-by-step guide to their own storage (chapter 6).
2.9 Selling access with Stripe
A maker can sell access to a tool, through their own Stripe: Edit tool → Makers and publishing → Sell with Stripe, a guide step by step. Stripe sells, with Managed Payments (Stripe is the merchant of record: it takes the payment, handles VAT and sends receipts). Blackslate never takes payments and never sells: it opens the tool to the people Stripe says have paid, and closes it when their access ends.
- The maker, once: Managed Payments in their Stripe, a payment link per price (back to
https://leavenit.com/o/<tool>/?purchased=1), a restricted key, read only (never the secret keysk_…; kept in Blackslate's vault), Stripe's events to Blackslate (a webhook endpoint, API version 2026-04-22.dahlia or later, its signing secret), their prices and levels (Standard, Pro…), the customer portal link, a test purchase in Stripe's test mode, then Open the sale. - While the sale is open, the tool opens only to its makers and to the people with access, and can't be copied.
- The buyer: on the tool's page, a button per price, Stripe's payment page, then back: "Your access is ready", and the tool is in My tools. Manage my subscription leads to Stripe's portal (cancel, change card, receipts).
- Then Stripe's events: a renewal extends access; a cancelled subscription, or a failed payment, keeps it until the end of the paid period; a full refund closes it. A sale made without Managed Payments opens nothing.
- Levels: the tool reads its buyer's level (
window.leavenit.context.access, chapter 5) and its published tables can be reserved to some levels: that is the real protection, since a tool's code can be read. - The maker sees each buyer's username, nothing else. Selling is the maker's business, and Stripe's: check your own tax obligations.
2.10 Apps in several files
A tool that grows can become an app in several files: pages that share their data (analysis, comparison, portfolio), each file changed on its own.
- Creating one: in Add a tool, if your AI answers in several files (
### File: pages/index.html…), Blackslate recognises an app. The check shows its files; Try it opens it, every page included. - Changing one: on the open app, ⋯ → Change this page (or Edit): pick the page, describe the change. Your AI gets the project map and the files of that page only, not the whole app. If it needs another file, it says so (
### Need files): one click copies it. Its answer shows file by file (lines added and removed, See), Try it without saving, then Save: only the changed files are sent, as a new version. - When a tool gets big (over about 2,000 lines), the next change also asks your AI to split it into files: saved, it becomes an app. The version before stays in the history. Edit → Turn it into an app does it at once, as it is.