# Boxes Manager Source: https://docs.mindli.com/.old/boxes In Boxes View you get a all your Main and sub Boxes > Before you can think out of the Box, you have to start with a Box" > — Twyla Tharp 1941- (Dancer and author, "The Creative Habit: Learn It and Use It for Life") * Set and Manage your thinking in Boxes based on topics, projects, or other methods. * Set your Main Boxes for your main level thinking, arrange and reorder your thinking in Sub-Boxes. * Revisit Boxes view to update your goals priorities, and order. # Sparks Manager Source: https://docs.mindli.com/.old/sparks In Sparks View you get a feed view of your Sparks > "From a small spark may burst a mighty flame" > — Dante Alighieri 1265–1321 (Italian poet, writer, and philosopher, best known for the poem, "The Divine Comedy") * Explore your added Sparks in Inbox (red badge). * See your Pinned Sparks from your Boxes. * Tip: use text search in All sub-view. # Changelog 2023 Source: https://docs.mindli.com/changelog/changelog2023 The history of MindLi in 2023 This release introduces sharing and collaborations and a comprehensive list of new features and capabilities: * You can now invite collaborators to Group Boxes and work together on Sparks! * Added capability for shared Boxes (future prep) * Can now pull to refresh sparks inside a Box * Added new deep links for the app now have a web landing page for better UX if the app is not installed / available (currently on Box invite links only, will be applied more broadly soon!) * Added new “Open in Browser” action for Sparks with URLs * Supports creating Sparks from other apps by sharing files * Added the ability to pull to refresh Boxes in Plan mode * Added an x button in the text field for searching Boxes in the Box picker * Added analytics events for the onboarding flow * Can now add new Boxes inside other Box views (from the top + menu) * Default Spark type is now Note Spark * Added Stat events for sharing and leaving Boxes * Improved support for creating Sparks when URLs don’t start with http\:// or https\:// * Added the Inbox icon * Improved animations (iOS) * Added an option to request email change for your account * Improved experience when capturing file Sparks * Added infrastructure for push notifications * Will now ask for push notification permissions after logging in * Added forgot password option after logging in * Graphics updates to Thinking Views * Changed the icons in the Box picker * Added confirmation when leaving a shared Box * Disabled app in landscape view * Added a new password field with the ability to see the password (eye icon) * Change Text: in Settings * Adding Licenses page to Settings * Fix Confirmation of deleting Box to the new confirmation style * Adding confirmation to invite collaborators * Show the default box icon on Settings * First version in the Apple store * First version of Graphics # Changelog 2024 Source: https://docs.mindli.com/changelog/changelog2024 The history of MindLi in 2024 # History * Enhancements and fixes for AI features * Enhancements and fixes for WhatsApp feature * Various visual improvements * Various maintenance improvements * Merry Christmas 🎄 🎅 🎁 * Unify 3 views: Home, Boxes, Sparks * "Think with AI" on Spark and on Box * Spark by WhatsApp (both text and image) * Feed menu in Sparks View * Boxes View Sub-views: All, Main | Personal, Groups * Spark View Sub-views: All, Pinned and Inbox * Settings Sub-views: General, Add Spark and Advanced * On Box View: New display menu for: Style (list, feed) and Order * Stas View (Labs): Initial measurement of thinking * Update onboarding to allow for WhatsApp * First version in four platforms (iOS, Android, Web and Chrome/edge) * New feature – Initial design for Spark from WhatsApp. You can now add your phone number and start sending Sparks to yourself (text only for now) * New Feature – We added a new view shows your recently captured Sparks in a feed style view * Enhancement – Added actions menu to oldest Sparks in Stats * Enhancement – Added remaining Info Sections * Enhancement – initial infrastructure for individual AI prompts * Fix – Escape bug * Fix – Creating a new Box while editing another * Fix – Gray cover images * Fix – Define default Box escape * Fix – Disappearing red badge * Minor visual changes * Various backend improvements * New feature – You can now choose your Spark’s cover image when using the share option on any browser or app, similar to the Chrome extension (some websites might have privacy settings that suppress this feature) * Enhancement – New icons for views * Enhancement – Improved and harmonized the Onboarding * Enhancement – New design for Info sections, you can now collapse them, remove them completely, and bring them back using the * Enhancement – Phase 1 of the new Stats design * New Feature – “AI Suggest Box” automatically checks your list of Boxes and suggests the relevant ones for your Spark * Fix – Collaborative Boxes toggle bug * Enhancement – New mechanism for AI on a Box * Enhancement – Minor visual changes * Enhancement – Various backend improvements # Changelog 2025 Source: https://docs.mindli.com/changelog/changelog2025 The history of MindLi in 2025 # History Maintenance version with minor updates and fixes * Minor visual updates * Infrastructure preparation for supporting additional file types in Spark by WhatsApp * Set the date and time display to match the local device Maintenance version with minor updates and fixes * Improved AI on Add Sparks from WhatsApp (you will see more suggested Boxes) * Faster initial login * Fixed bug in Starred Sparks for some users * Minor visual fixes to (M) menu Please be advised that the entire MindLi AI system is now connected to GPT-5 models. So lots of behind-the-scenes changes. * Update AI to connect with GPT-5 * Faster Add Spark on mobile (include Edit) * Optimize Home view load Visual enhancements and bug fixes * Our Trash Manager (for Sparks and Boxes) * New M side menu (wow!) * New Recent Sparks and Boxes * New Starred Sparks and Boxes Visual enhancements and bug fixes * Simplified One Spark & One Box views with sub-views * Box Selector updates * Speed improvements on the Home view * Fine-tuned WhatsApp auto box suggestions for images * WEB: Updated Sparks & Boxes look on Home view Minor enhancements and bug fixes In addition to regular maintenance, this version introduced the “*Boxes Outline*” feature. With Outline, you can expand or collapse Boxes to view their sub-boxes. In a related feature, we introduced a Sub-Box “*Reorder*” feature that allows you to arrange the Boxes as you wish. * Formally Introducing the Box Outline (as seen in these views: Home, Boxes, and Box Selector) * Subbox's Reorder * Visual enhancements for mobile should unify the Spark look as seen on the web * Initial work on “Box Selector” to enhance usability * Optimized AI Suggest of Boxes. And auto Title creation from Add Spark by WhatsApp This maintenance version is a significant update to the platform interface * WEB - LABS - Outline view—give it a try (it's unified in Home View, Boxes View, and Box Manager) * Unified Details section for Sparks and Boxes * Home view lazy loading—resulting in faster loading speeds * Optimized AI Suggest for Boxes * Enhanced unified infrastructure and user experience for iOS and Android Regular maintenance version * The user-selected Spark order of the Box is now saved * Skeleton view of Sparks in Home view (WEB) * AI Suggest of Boxes considers the current connected Boxes better * “Duplicate and connect to the Inbox” sub-menu (WEB, AND) * Enhanced unified infrastructure and user experience for Archive Sparks * Enhanced unified infrastructure for Group Boxes * Fine-tune the WhatsApp number updating * Enhanced search results presentation, including “matches content” badge Visual and maintenance version for the Add Spark Chrome extension * Three buttons on top: Clear, Reload, Save - matching our web design * Visual Update open screen * Faster auto load of Spark Content from the page * AI Box suggestion per Spark -- look for the MindLi AI "wand." * Unify Connected Box menu (including "Add New Box..." in place) * Setting > Adding Sign Out option (red) will also sign out from the web (mostly for security, and if you are using several users) * Setting > Add direct access to "Help Center", and to "My MindLi" Regular visual and maintenance version * AI Box Suggestion per Spark improvements * Settings > New tab for MindLi AI * States > 4 oldest Sparks to connect replaced with a message when Inbox empty (“green badge”) * Web - Infinite scroll on Home view * Web - Multifocal display of Sparks and their Content improvements * Chrome Extension - Support AI auto Boxing * Labs - Fix permissions for group Box actions by roles Regular maintenance version * Under M+ menu - “Add New Spark from WhatsApp” * Labs - New group Boxes roles, Owner, Author * IOS - internal update to backend connection * Minor visual and performance updates This update improves search speed, AI accuracy, and overall performance. * Faster and more efficient search * AI delivers quicker and more precise results * Clearer messages and smoother changes * General fixes and improvements This maintenance version primarily includes visual updates and harmonizations on all platforms * Fresh Icons & Menus: Updated M+ menu and ellipsis icon for a sleek, modern experience * Bug Fixes & Optimizations: Squashed minor glitches to ensure faster, more reliable apps This stability and maintenance version includes mostly visual updates, harmonizations across all platforms, and edge bug fixes * Update: 2025 Year * Enhancement: Harmonize order menu on all platforms * Unify: Visual highlight in search * Unify: Icons in bulk edit of Sparks * Happy New Year 🥳 🎆 🍾 # Changelog 2026 Source: https://docs.mindli.com/changelog/changelog2026 The history of MindLi in 2026 # Current Versions | System | Current version | Get it | | :-------- | :---------------- | :-------------------------------------------------------------------------------------------------------- | | Web App | MND-WEB 2.4.9 B11 | [Access](https://app.mindli.com) | | Apple iOS | MND-IOS 2.4.9 B10 | [Store](https://apps.apple.com/us/app/id6467678555) | | Android | MND-AND 2.4.9 B10 | [Store](https://play.google.com/store/apps/details?id=com.danmnd.MindLiAND) | | Chrome | MND-CHR 2.4.10 B2 | [Store](https://chromewebstore.google.com/detail/lkaanmelncdcpikhjpadjkegioolpdeb) | | WhatsApp | MND-WAP 2.4.9 B11 | [Configure](/get-started/quickstart#quickstart-whatsapp-setup) | # History The flying elephant ✈️🐘 * Preview video files directly inside Sparks, with clearer playback and video icons * Faster Spark by WhatsApp confirmations that show the saved media and Connected Boxes * Smoother Trash and restore flows, with clearer visibility of trashed Sparks inside trashed Boxes * Improved Create with smoother scrolling and cleaner Spark Names suggested from links * Clearer Chrome extension feedback when a page cannot be added as a Spark The flying elephant ✈️🐘 * Ready for Android API 36 * Simplified and unified how you move Boxes and connect or disconnect Sparks from Boxes * Box Suggestions for Sparks now also use Google Gemini 3.5 Flash * Prepared MindLi for MCP integration The flying elephant ✈️🐘 * Improved returning to Home and Boxes by preserving context and highlighting the Spark you just viewed (“orange hallo”) * Enhanced bulk Spark and Box actions with clearer selection, role-aware choices, and named feedback * Added promo-code redemption and clearer subscription information across onboarding and Settings * Improved Spark by WhatsApp replies with support for media messages The flying elephant ✈️🐘 * Enrich any Spark with its link — including YouTube — and let MindLi suggest a title, summary, and cover image * Generate Spark cover images directly in Create, with AI operations tailored to your content * Your Create results are now preserved if you cancel adding a new Spark — nothing is lost mid-flow * Subscription management is now available directly from onboarding and Settings for a smoother upgrade experience Maintenance version with updates and fixes * Updated the file system to enhance privacy * Improved error handling for large files in Spark by WhatsApp * Updated Create operations order, with the most common actions at the top The flying elephant is here ✈️🐘 * Stabilized Spark file and cover image behavior, enabling faster URL updates and better display * Improved WhatsApp Spark uploads for files and images with enhanced error tracking * Refined sign-in with better OAuth consent, Google account selection, and clear sign-out options * Polished home and Spark views with aligned icons, updated stats, limited connected Boxes in previews, and set Spark size to “Large+Boxes" Maintenance version with updates and fixes based on Tribe feedback * Fine-tuned search behavior * Fixed an editor issue in Create Major version with updates and performance improvements for the flying elephant version ✈️🐘 * Enhanced search across Sparks and Boxes directly from Home * Smoother, updated Spark cover image modal experience * Refactored Help system with new MindLi icons and fresh content * Significantly faster Create AI operations and reduced wait times * Enhanced Spark views with new Basics and Basics + Details layouts Major version with updates and fixes * Optimized navigation and core shell. * Integrated Spark and Box Composer. * Unified left (M) bar with ABC thinking method embedded. * Polished system-wide dialog interface. * Focused on maintenance and reliability, especially regarding Trash functionality. Maintenance version with updates and fixes * Unified (M) menu to include Add, Box, and Create. * Unified control area on Home, Box, and Spark. * Unified Settings for ABC model: Add, Box, and Create. * Settings: Create now shows all operations, including global and personal. * The first version of Create was launched on Home and with 3 All Boxes new operations. Maintenance version with minor updates and fixes * Onboarding updates to align with the new tagline and subscription screen * Search improvements for better results and faster performance * Minor fixes and performance optimizations across all platforms Key updates and fixes * Preparing for the major 26Q1 release * The MindLi tagline "Let's think… together" has been updated * The subscription screen has been updated * Visual consistency across the app aligning with Add Sparks, Box them, and Create outcomes * Improvements to the user experience for Spark by WhatsApp messaging Key updates and fixes for version 2.2 * Visual Enhancements: Significant UI/UX updates across the platform * Foundation for 2.2: Heavy lifting on infrastructure to prepare for our next major milestone * Voice-to-Spark: Performance improvements for creating Sparks via WhatsApp voice notes Internal version with key updates and fixes for version 2.2 * Update to some internal server and client components to enable future features # Get it Source: https://docs.mindli.com/get-it Access MindLi on web, mobile, and Chrome Use the links below to access MindLi on the web or install it from the official stores. | System | Current version | Get it | | :-------- | :---------------- | :-------------------------------------------------------------------------------------------------------- | | Web App | MND-WEB 2.4.9 B11 | [Access](https://app.mindli.com) | | Apple iOS | MND-IOS 2.4.9 B10 | [Store](https://apps.apple.com/us/app/id6467678555) | | Android | MND-AND 2.4.9 B10 | [Store](https://play.google.com/store/apps/details?id=com.danmnd.MindLiAND) | | Chrome | MND-CHR 2.4.10 B2 | [Store](https://chromewebstore.google.com/detail/lkaanmelncdcpikhjpadjkegioolpdeb) | | WhatsApp | MND-WAP 2.4.9 B11 | [Configure](/get-started/quickstart#quickstart-whatsapp-setup) | # The ABC Thinking Steps Source: https://docs.mindli.com/get-started/abc-steps Start Simple, Continue Smart ## Overview MindLi enables a simple and smart thinking flow, that is both common and universal: **Add (input) → Box (process) → Create (output)**. We assume that all thinking is about collecting information (Add), organizing it (Box), and generating meaningful output (Create). Our goal is to streamline this ABC workflow with AI, while keeping it simple to use for us humans. In our design we follow Albert Einstein: "Everything should be made as simple as possible, but not simpler." ## Start Simple Start in minutes: * A. **Add Sparks:** Send or forward a message (text, image and voice ) to our "Add Spark" WhatsApp sensor * B. **Box them:** Watch it appear in your Inbox, add other Boxes as needed * C. **Create with your Sparks and Boxes:** AI will automatically generate enhancements to your Sparks and Boxes - Say goodbye to lost WhatsApp messages that you send to yourself. - Dazzle yourself by sending an image of your desk to MindLi with WhatsApp and automatically get a Spark describing it in your Inbox. ## Continue Smart Evolve your MindLi thinking with over 60 advanced features to match your thinking styles and needs: * A. **Add Sparks:** Add other media types like URLs, web clippings, files, and more * B. **Box Them:** Organization with AI, deep search, and connect a Spark to several Boxes * C. **Create with your Sparks and Boxes:** Use AI to generate meaningful output (decisions, reflections, deeper knowledge, etc.) - Each person thinks in a different way, so we designed MindLi to evolve with your thinking style. While AI takes the heavy technical lifting (translate, summarize, analyze, etc), you are in control of your thinking. ## Cool Features to Look For * **Global Search:** Find any Spark or Box * **AI-powered Add Spark:** Automatic transcription, image description, and more * **Bulk Sparks Management:** Select, move, delete, and process multiple Sparks at once * **Weekly AI Digest:** A weekly email summary of your thinking activity, delivered to your regular email Inbox * **Endless Trash:** Sparks and Boxes are kept forever in the Trash, until you permanently delete them * **Cross-Platform:** Use MindLi on Web, iOS, Android, and Chrome/Edge extension - We are constantly working on new features, while keeping the core ABC steps simple and easy to use. - Reach us at our built-in feedback form: [https://mindli.com/feedback](https://mindli.com/feedback). # Mission Source: https://docs.mindli.com/get-started/mission What is MindLi's mission and how do we achieve it? ## Our Mission Our goal: Human thinking in the age of AI – Why, What, and How * **The Why** – The Challenge: In an AI-driven world, we face endless opportunities—and negative complexities. Information overload leads to stress, lost time, and missed potential. * **The What** – The Solution: MindLi is a practical, AI-enabled platform that empowers human intelligence. It’s a dedicated environment built for a lifetime of current and future thinking. * **The How** – The Method: MindLi enables a simple and smart thinking workflow: * Simple: We start with the ABC steps for thinking: **Add** (input) → **Box** (process) → **Create** (output). * Smart: More than 60 features to match your evolving thinking needs. # All Your Sensors Source: https://docs.mindli.com/get-started/patterns/all-sensors Every way to add a Spark to MindLi — and how to make the most of each one ## Overview A sensor is any channel you use to get content into MindLi. The more sensors you activate, the less friction between a thought and a Spark — so you capture more, lose less, and keep your thinking flowing. All Sparks land in your **Inbox**, regardless of which sensor adds them. *** ## WhatsApp The fastest sensor. Send anything to MindLi's number — **+1 (209) 717 7762** — and it becomes a Spark. Supports: text, URLs, images, voice notes, and files. Captions on media become the Spark's content. **Setup:** > ** Settings** > **Add** > Add Spark with WhatsApp Save the number as **"MindLi Add Spark"** in your contacts so you can forward to it from any conversation in seconds. See the full [WhatsApp Sensor](/get-started/patterns/whatsapp-sensor) article for tips on forwarding and captions. *** ## Chrome / Edge Extension Capture any webpage as a Spark while you browse — without switching apps. Also required for Split View to load web content inside MindLi. **Install:** [Chrome Web Store](https://chromewebstore.google.com/detail/lkaanmelncdcpikhjpadjkegioolpdeb) — pin the extension so it's always one click away. *** ## Mobile Share Sheet On iOS and Android, use the native **Share** button in any app to send content directly to MindLi. Works for links, text, images, and files shared from your browser, notes app, photos, or anywhere else. No setup needed — MindLi appears in your device's share sheet once the app is installed. *** ## Email (Labs) Send or forward any email to **[addspark@mindli.com](mailto:addspark@mindli.com)** and it becomes a Spark. Supports: text body and one attached file or image. By default, MindLi accepts mail from the email address you signed up with. You can approve additional addresses in Settings. **Setup:** > ** Settings** > **Add** > Labs - Email Email is a Labs feature — it works well but may evolve. It's especially useful for forwarding newsletters, receipts, or research you want to keep. *** ## Manual Add Create a Spark directly inside MindLi at any time. ** > ADD > New Spark** — type a note, paste a URL, or upload a file. Use this when you're already in MindLi and want to add something without switching context. *** ## Which Sensor to Use When | Situation | Best sensor | | ------------------------- | ------------------------------------------------------------ | | Thought in a conversation | WhatsApp — forward it | | Article while browsing | Chrome extension | | Content from another app | Mobile share sheet | | Email you want to save | Forward to [addspark@mindli.com](mailto:addspark@mindli.com) | | You're already in MindLi | Manual add | # Building Your Boxes Source: https://docs.mindli.com/get-started/patterns/building-your-boxes How to structure Boxes so your thinking stays organized as it grows ## Overview A Box is not just a folder. It's a thinking space — a container with its own Sparks, Sub-Boxes, AI insights, and structure. Getting Box design right makes the difference between a system you return to and one you abandon. *** ## Name with Intent A good Box name tells you at a glance what belongs inside — and what doesn't. * Prefer specific over generic: **"Trip to Greece — May 2026"** beats **"Travel"** * Include a time anchor when relevant: **"Q3 Planning"**, **"Book — July Read"** * Avoid single-word names unless the scope is truly that narrow Duplicate Box names are allowed but not recommended — they create confusion when searching or assigning Sparks. *** ## Use Sub-Boxes to Add Depth When a Box grows beyond 20–30 Sparks, or when it contains clearly separate topics, split it with Sub-Boxes. A well-structured nesting example for a freelance designer: ``` Work ├── Client — Acme Corp │ ├── Briefs │ ├── Feedback │ └── Deliverables ├── Client — Bloom Studio │ ├── Briefs │ └── Deliverables └── Admin ├── Invoices └── Contracts ``` Each leaf Box stays focused. The parent Boxes give you a quick overview without drowning in Sparks. *** ## A Practical Day-to-Day Setup Here's a simple structure that works for most people: ``` Inbox ← all new Sparks land here Now ← what you're actively working on this week Projects ← one Sub-Box per project Learning ← articles, books, courses Ideas ← raw thoughts not yet tied to a project Archive ← completed work, kept for reference ``` The key habit: once a week, open Inbox and move Sparks into the right Box. Keeps everything clean without requiring real-time organization. *** ## Connect a Spark to Multiple Boxes A Spark doesn't have to live in just one Box. Connect it to every Box where it's relevant. For example, a research article about pricing strategy could belong to both **"Client — Acme Corp"** and **"Learning"**. Tap ** Boxes** on any Spark to add or remove Box connections. You can also let AI suggest Boxes for you. *** ## Keep Home Clean with Star and Archive * **Star** your most active Boxes to keep them prominent on Home * **Archive** Boxes you're done with — they stay searchable but disappear from your main view * Use ** Filter** on Home to switch between active and archived views when you need to reference old work *** ## AI Works Better with Good Box Structure The more focused a Box is, the better AI Create performs when generating insights across it. A tightly scoped Box like **"Client — Acme Corp > Feedback"** will produce sharper summaries and more actionable output than a broad catch-all Box. # Guidelines & Limits Source: https://docs.mindli.com/get-started/patterns/limits Platform guidelines and limits for Sparks and Boxes in MindLi This article covers the guidelines and types of limits that apply to Sparks and Boxes across MindLi platforms. ## Field Guidelines & Limits The following guidelines and limits apply to both Mobile (Android & iOS) and Web: ### Spark Fields | # | Spark Field | Required? | Guidelines and Limits | | - | --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | 1 | Spark Name | Yes | 3–100 characters. `<` and `>` are not allowed. | | 2 | Connected Boxes | Yes | Select at least one Box where the user has permission to add the Spark. Multiple Boxes may be selected. | | 3 | Content | No | No explicit maximum is currently enforced. | | 4 | Attached | No | One Link, Image, Audio, or File can be attached. Links must be valid URLs, and uploads must meet the supported format and file-size limits. | | 5 | Cover Image | No | Must be a supported image. It may be uploaded, pasted, generated, or derived from an attached image. | ### Box Fields | # | Box Field | Required? | Guidelines and Limits | | - | ----------- | --------- | ----------------------------------------------------------------------------------------- | | 1 | Box Name | Yes | 2–50 characters. `<` and `>` are not allowed. | | 2 | Parent Box | Yes | A Box may have one Parent Box, or it may be placed directly under Home at the main level. | | 3 | Description | No | No explicit maximum is currently enforced. | *** ## Supported File Formats ### WhatsApp Add Spark For setup and usage instructions, see the [WhatsApp Sensor](/get-started/patterns/whatsapp-sensor) article. Add Spark by WhatsApp sensor accepts: | Type | Formats | | --------- | ----------------------------- | | Images | JPG, JPEG, PNG, WEBP\* | | Audio | OGG, AMR, 3GP, AAC, MPEG | | Documents | PDF, DOC, DOCX, PPTX, XLSX | | Video | MP4 (H.264 video + AAC audio) |

\* WEBP images are treated as stickers by WhatsApp and may have size/format restrictions.

Other formats are not supported by WhatsApp. ### Manual Upload (Mobile & Web) | Category | Supported Formats | | ------------- | -------------------------------------------------------------------------------------- | | Images | PNG, JPG, JPEG, WebP, GIF, BMP, TIFF, SVG, HEIC, HEIF, AVIF | | Documents | PDF, DOC, DOCX, RTF, ODT | | Spreadsheets | XLS, XLSX, CSV | | Presentations | PPT, PPTX | | Text | TXT, MD, JSON, HTML, XML | | Code | JS, JSX, TS, TSX, PY, JAVA, CPP, C, CS, RB, GO, RS, PHP, SWIFT, KT, SH, SQL, YAML, YML | | Audio | MP3, MPGA, WAV, OGG, M4A, AAC, FLAC, WMA, MIDI, AIFF | | Video | MP4, MOV, AVI, MKV, WebM, MPEG, MPG, M4V, FLV, WMV, 3GP, 3G2 | | Archives | ZIP, GZ, TAR | **Maximum total message size:** 16MB\ **Images specifically:** 5MB On mobile, HEIC and HEIF images are automatically converted to JPEG on upload for broader compatibility. # Move Boxes And Connect Sparks Source: https://docs.mindli.com/get-started/patterns/move-boxes-connect-sparks Understand how Sparks and Boxes relate, and what happens when you move, connect, or restore them ## Overview A Spark is never alone. Every Spark in MindLi is connected to at least one Box — this is the core rule that keeps your thinking organized and reachable. Understanding how Sparks and Boxes relate helps you organize confidently without losing track of anything. *** ## A Spark Is Always Connected Every Spark must be connected to at least one Box. When you add a new Spark, it automatically connects to **Inbox** (your default Box). A Spark can connect to multiple Boxes at once. For example, a recipe could belong to both **"Healthy Eating"** and **"Quick Dinners"**. ``` Spark: "15-Minute Salmon Bowl" ├── Connected to: Healthy Eating └── Connected to: Quick Dinners ``` Tap ** Boxes** on any Spark to view and edit its connections, or let AI suggest relevant Boxes. *** ## Connecting and Disconnecting Sparks | Action | What happens | | ----------------------- | --------------------------------------------------------------------- | | **Connect to Box** | The Spark appears in the new Box while staying in its existing Boxes | | **Disconnect from Box** | The Spark is removed from that Box but stays in other connected Boxes | If you connect a Spark to a new Box, MindLi can optionally disconnect it from Inbox automatically. Enable this in ** Settings** > ** Box** > **Auto Disconnect from My Inbox**. *** ## Moving Boxes Moving a Box means changing its parent — placing it under a different Box or making it a top-level Box. | Scenario | Result | | ------------------------------ | ----------------------------------------------- | | **Move Box under another Box** | The Box becomes a Sub-Box of the new parent | | **Move Box to top level** | The Box appears directly on Home with no parent | When you move a Box, all its Sub-Boxes move with it automatically, preserving the entire structure. Sparks inside a moved Box stay connected as-is. Moving a Box does not affect Spark connections. *** ## What Happens When You Trash a Box When you move a Box to Trash, MindLi checks whether any Sparks would be left without an active Box. | Spark situation | Options | | ------------------------------------ | --------------------------------------------------------------- | | **Spark has other active Boxes** | No change needed — the Spark stays connected to those Boxes | | **Spark would have no active Boxes** | Choose to **Move Spark to Trash** or **Connect Spark to Inbox** | Trashing a Box does not delete its Spark connections. The connections are preserved so you can restore everything later. *** ## Sub-Boxes When Trashing When you trash a Box that has Sub-Boxes, you choose what happens to them: * **Move Sub-Boxes to Trash** — Sub-Boxes go to Trash along with the parent * **Move Sub-Boxes up** — Sub-Boxes move up one level (to the parent Box or Home) and stay active ``` Before trashing "Projects": Home └── Projects ← trashing this ├── Website └── Mobile App After trashing (with move up): Home ├── Website ← moved up to Home └── Mobile App ← moved up to Home ``` *** ## Restoring from Trash When you restore a Spark or Box from Trash, MindLi reconnects it to its original Boxes when possible. | Restore scenario | What happens | | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | **Spark's original Boxes are active** | Spark reconnects to those Boxes | | **Spark's original Boxes are trashed** | Spark connects to **Inbox** | | **Box with trashed Sub-Boxes** | Choose to restore them (Sub-Boxes and Sparks come back) or keep them trashed (only the selected Box is restored) | **Example:** You trash a Box called "Old Project" and its Sparks. Later, you restore one of those Sparks. Because "Old Project" is still trashed, the Spark automatically connects to Inbox so it remains accessible. *** ## Quick Reference | Action | Spark connections | Box structure | | ----------------------------------- | ------------------------------------------------------ | -------------------------------- | | **Connect Spark to Box** | Spark added to new Box | No change | | **Disconnect Spark from Box** | Spark removed (if other Boxes exist) | No change | | **Move Box** | No change | Parent updated | | **Trash Box** | Preserved (Sparks optionally trashed or sent to Inbox) | Box moves to Trash | | **Restore Box** | Preserved | Box returns to original location | | **Restore Spark (no active Boxes)** | Connects to Inbox | No change | # Tips for Multi-Device Use Source: https://docs.mindli.com/get-started/patterns/multi-device-use Use MindLi smoothly across web, iOS, and Android ## Overview MindLi works best when each device has a clear role. Use your phone for fast capture, your computer for focused review, and your Inbox as the shared handoff point between them. *** ## Use the Same Account Everywhere Sign in with the same MindLi account on web, iOS, and Android so your Sparks, Boxes, and settings stay connected. If something you added on one device does not appear right away on another, use ** Refresh Data** from the relevant screen. For account and sign-out tips, see [Sign-In Tips Across Devices](/get-started/patterns/sign-in-across-devices). *** ## Match the Device to the Moment | Device | Best for | | ------------ | -------------------------------------------------------------------- | | **Phone** | Quick Add Sparks, voice notes, photos, mobile sharing, WhatsApp | | **Tablet** | Reading, reviewing attachments, Split View | | **Computer** | Organizing Boxes, editing longer Sparks, browsing with the extension | You do not need to organize every Spark the moment you capture it. Let quick inputs land in **Inbox**, then clean them up later from the device where you have more time. *** ## Capture From Anywhere Use the fastest sensor for the device you are already using: * **WhatsApp** for forwarding messages, links, images, and voice notes * **Mobile share sheet** for sending content from iOS or Android apps * **Chrome / Edge extension** for capturing webpages while browsing on your computer * **Manual Add** when you are already inside MindLi All new Sparks land in Inbox first, no matter which device or sensor added them. *** ## Avoid Editing the Same Spark in Two Places MindLi keeps your data connected, but it is still best to finish editing a Spark on one device before opening and changing the same Spark somewhere else. If you switch devices mid-edit, save your change first, then open or refresh the Spark on the next device. *** ## Keep One Cleanup Habit Choose one regular cleanup place, usually web or tablet: 1. Open **Inbox** 2. Review new Sparks 3. Connect them to the right Boxes 4. Archive or delete what you do not need This keeps mobile capture fast without letting Inbox become permanent storage. # Sign-In Tips Across Devices Source: https://docs.mindli.com/get-started/patterns/sign-in-across-devices Use the right account and sign-out option on every device ## Overview These tips help you keep the same MindLi available on web, iOS, and Android, while keeping your account private and secure. *** ## 1. Use the Same MindLi Account on Every Device Sign in with the same MindLi account on web, iOS, and Android so your Sparks, Boxes, and settings stay connected. If you use different sign-in methods or different email addresses, you may end up in a different MindLi account. *** ## 2. Recommended: Use Your Google Account Your Google account is usually the easiest way to sign in across devices. This can be your Gmail account, or any other account managed by Google. Tap ** Continue with Google** and choose the Google account you want connected to MindLi. *** ## 3. If the Wrong Google Account Opens, Switch Accounts First If Google opens the wrong account, switch before completing sign-in. On web, choose another account in the Google sign-in screen, or sign out of the wrong Google account in your browser first. On mobile, close the sign-in screen and start again with the account you want to use. *** ## 4. Choose the Right Sign-Out Option for Privacy and Security Use **Sign Out** when you only want to leave MindLi on the current device. This is the right choice for your own phone, tablet, or computer when you simply want to end the current session. Use **Sign Out From All Devices** when privacy or security matters across every device. This signs you out of MindLi on this device and any other devices where you're signed in. Use it if you lost a device, used a shared computer, or want to disconnect all active sessions. *** ## 5. Advanced Tip: Using Several Google Accounts If you use several Google accounts, make sure you choose the account connected to the MindLi you want to open. On web, Google sign-in lets you choose from Google accounts that are already signed in to your browser. On mobile, tap **Continue with Google** for normal sign-in. To show the Google account chooser, long-press **Continue with Google**. *** ## 6. Refresh After Switching Devices or Signing Back In If something looks stale after signing in again, use ** Refresh Data** on the relevant screen. # Split View Source: https://docs.mindli.com/get-started/patterns/split-view Read your source material and work on your Spark at the same time ## Overview Split View lets you see a Spark and its attached content side by side in the same screen. Instead of switching back and forth between a link, image, or file and your notes, both stay visible at once — so you can read, compare, and create without losing your place. *** ## How to Open Split View Open any Spark that has an attachment, then tap the ** Split View** button (a expand/collapse icon) in the Spark toolbar. Choose one of three modes: | Mode | What you see | | --------------------------- | ------------------------------------------ | | **Spark Only** | The Spark without its attachment | | **Split: Spark + Attached** | Spark on one side, attachment on the other | | **Attached Only** | Full-screen view of the attachment | Drag the divider between the two panels to adjust how much space each side gets. *** ## When to Use It Split View is most useful when a Spark contains content worth reading alongside your notes: * A saved **article or webpage** — read and annotate at the same time * A **PDF** — review the document while writing your takeaways in the Spark * An **image** — keep the visual in view while editing the Spark's description * A **voice note transcript** — listen while editing the auto-generated text *** ## On Web *rotated for side-by-side panels* On the web app, Split View loads the attached URL inside MindLi's own window and requires the **MindLi Chrome/Edge extension** to be installed and active. [Install the Chrome/Edge extension](https://chromewebstore.google.com/detail/lkaanmelncdcpikhjpadjkegioolpdeb) and pin it for best results. Some websites block embedding. If a link won't load in Split View, open it in a new tab instead using the link icon on the Spark.
MindLi web Split View showing a Spark next to an attached webpage
*** ## On Mobile (iOS & Android) *vertical expand* On iOS and Android, Split View opens files and images natively on your device — no extension needed. The same button opens content alongside your Spark for side-by-side reading and editing. Supported attachment types: images, PDFs, files, and other native content. In the image below, the orange striped lines show the Split View attachment area.
MindLi mobile Split View showing a Spark next to attached content
# WhatsApp Sensor Source: https://docs.mindli.com/get-started/patterns/whatsapp-sensor Get the most out of the fastest way to add Sparks — from any message, image, voice note, or link ## Overview The WhatsApp sensor is the fastest way to add a Spark to MindLi — no app switch, no login, no friction. Anything you send to MindLi's WhatsApp number lands in your Inbox automatically, processed and ready to work with. MindLi's WhatsApp number: **+1 (209) 717 7762** Save the number in your contacts as **"MindLi Add Spark"** so it's easy to find and forward to. ## Setup 1. Go to > ** Settings** > **Add** > **Add Spark with WhatsApp** 2. Enter your mobile number and verify it 3. You're set — start sending ## What You Can Send Every message type becomes a Spark: | What you send | What you get | | -------------- | ---------------------------------------------------- | | A text message | A Spark with that text as content | | A URL | A Spark with the link captured and auto-enriched | | An image | A Spark with the image + an AI-generated description | | A voice note | A Spark with the audio + an automatic transcript | | A file | A Spark with the file attached | ## Use Captions to Your Advantage When you send an image, voice note, or file, add a caption — it becomes the Spark's content alongside the media. * Send a photo of a whiteboard with the caption "Strategy session notes" → Spark titled automatically, your caption as context * Send a voice note "follow up with the team on pricing" → transcript added, caption preserved ## Forwarding is Powerful The forward feature in WhatsApp is one of the most useful capture habits in MindLi: * Forward an article link someone shared with you → captured as a URL Spark * Forward a voice message from a meeting → transcribed and saved * Forward a photo → described by AI and stored ## After Sending Once your message arrives, MindLi sends back a confirmation with a direct link to the new Spark in your Inbox. AI enhancements — title, description, image description, transcription — are applied automatically in the background. Sparks always land in your Inbox first. Assign them to Boxes whenever you're ready — you don't have to do it at capture time. # Quickstart Source: https://docs.mindli.com/get-started/quickstart Start building your MindLi in under 5 minutes. ## Setup If you do not have a user, go to [https://app.mindli.com](https://app.mindli.com).
(We recommend you use a Google account to ease login on other platforms such as Android or iOS). * Do the onboarding including adding your WhatsApp number for adding Sparks. * You will see some pre-loaded Sparks based on your onboarding. You can delete them later. * Try to add a Spark using the ** > ADD > New Spark**, top left. * Try to add a Box using ** > ADD > New Box**. You are good to go with the basic setup.
The web extension allows you to add Sparks from any website while browsing (it is also needed for our split web side-by-side display).
* [Download Chrome/Edge extension](https://chromewebstore.google.com/detail/lkaanmelncdcpikhjpadjkegioolpdeb). * Make sure you pin the M+ extension so it is visible for you. The Chrome MindLi extension is critical for showing webpages inside the MindLi window.
Our most popular sensor to Add Sparks.
If you have not set your mobile phone in the onboarding yet:
* Go to menu > Settings > Add > Add Spark with WhatsApp and set your mobile number.
* Save MindLi's number in your WhatsApp contacts as "MindLi Add Spark" for easy search.
* From now on, you can send messages (text, image, file, and voice) to MindLi, and it will be connected to your Inbox. * Try: take a picture of your room and get a verbal description of the room. * Try: send a voice message "I like to think", look for the Spark in your Inbox.
Use [Apple App Store to download MindLi](https://apps.apple.com/us/app/id6467678555)
Use [Google Play to download MindLi](https://play.google.com/store/apps/details?id=com.danmnd.MindLiAND)
Tip: use the same login method as on web (Google login is recommended). Now, you can also manage your Boxes and Sparks on mobile.
Roam the various screens on the web and mobile: * On web: go to this site [https://en.wikipedia.org/wiki/Bird](https://en.wikipedia.org/wiki/Bird); click on the M+ in Chrome/Edge to Add the Spark. * On mobile: go to the same site, use Share (into the app itself) to directly Add a Spark. * On mobile: take a selfie and send it to "MindLi - Add Spark" in WhatsApp, add caption "my selfie." * On WhatsApp: Record a voice message "My first Spark from WhatsApp" and send it to MindLi Add Spark. All four sparks should wait for you in your Inbox (same on web and on mobile). Continue to explore. MindLi is designed for self-discovery.
For more actions per screen, use the control buttons or the action buttons.
# Thinking Patterns Source: https://docs.mindli.com/get-started/thinking-patterns Advanced patterns for getting more out of MindLi ## Start Simple Go beyond the basics. These articles cover advanced features and habits that make MindLi faster and more powerful for your everyday thinking. WhatsApp Sensor} href="/get-started/patterns/whatsapp-sensor"> Get the most out of the fastest way to add Sparks — from any message, image, voice note, or link All Your Sensors} href="/get-started/patterns/all-sensors"> Every way to get content into MindLi — and when to use each one Building Your Boxes} href="/get-started/patterns/building-your-boxes"> Name, nest, and structure Boxes so your thinking stays organized as it grows Split View} href="/get-started/patterns/split-view"> Read your source material and work on your Spark side by side ## Continue Smart Tips for Multi-Device Use} href="/get-started/patterns/multi-device-use"> Use MindLi smoothly across phone, tablet, and computer Guidelines & Limits} href="/get-started/patterns/limits"> Field size limits, file upload limits, and supported file formats Move Boxes And Connect Sparks} href="/get-started/patterns/move-boxes-connect-sparks"> Understand how Sparks and Boxes relate, and what happens when you move, connect, or restore them Sign-In Tips Across Devices} href="/get-started/patterns/sign-in-across-devices"> Use the right account and sign-out option on every device # Using MindLi Source: https://docs.mindli.com/get-started/using-mindli Shared principles and controls that appear across MindLi. ## Overview MindLi uses a consistent set of controls across the main screens, including Home, Box, Inbox, Spark, Stats, and Trash. These controls are organized into four areas: 1. **Global Controls:** Access shared actions such as the MindLi menu, navigate back, Help menu, and Avatar menu 2. **Search Controls:** Search globally in Home or within the current screen or list 3. **Screen Controls:** Work with the main parts of the current screen 4. **View Controls:** Change how the current screen is displayed, including filtering, sorting, split view, preview size, and other view options MindLi mobile screen showing Global Controls, Search Controls, Screen Controls, and View Controls MindLi web screen showing Global Controls, Search Controls, Screen Controls, and View Controls ## Global Controls In most screens, you will find these shared controls: * The MindLi menu to quickly Add, Box, Create, and access other tools * Navigate back to return to the previous screen when available * The Help menu for inline help, Help Center, Support, and Feedback specific to the screen you are in * The Avatar menu to view your Recent and Starred Boxes and Sparks In most screens, you will also find Search Controls, Screen Controls, and View Controls. ### MindLi Menu The MindLi menu opens the left M bar. Use it to move through the core MindLi actions: Add, Box, and Create. For more about these thinking steps, see [The ABC Thinking Steps](/get-started/abc-steps). ### Back Button Use the back button to return to the previous screen when it is available. ### Help Menu The Help menu gives you support for the screen you are in: 1. ** Show Inline Help:** Display helpful information directly on the current screen 2. ** Help on This Screen:** Open contextual documentation for the current screen 3. ** Help Center:** Access the MindLi documentation at [https://docs.mindli.com/](https://docs.mindli.com/) 4. ** Support:** Get help from the MindLi support team at [https://mindli.com/support](https://mindli.com/support) 5. ** Feedback:** Share your feedback and suggestions at [https://mindli.com/feedback](https://mindli.com/feedback) 6. ** Copy Screen To Clipboard (Web only):** Capture and copy a screenshot of the current screen for sharing or reference ### Avatar Menu The Avatar menu gives you quick access to your personal MindLi shortcuts: 1. ** Starred Sparks:** View Sparks you marked as important, such as a key idea, a task you want to return to, or a reference you use often 2. ** Starred Boxes:** View Boxes you marked as important, such as your main project Box, a travel plan, or a work area you open often 3. ** Recent Sparks:** Return to Sparks you recently opened or worked with 4. ** Recent Boxes:** Return to Boxes you recently opened or worked with ## Search Controls Use the Search Controls to search globally in Home or within the current screen or list. ## Screen Controls Screen Controls work with the main parts of the current screen. * Home controls help you view presets, refresh data, and work across all Boxes and Sparks. * Box controls help you work with the current Box, its Sparks, Sub-Boxes, and Create actions. * Spark controls help you edit the Spark, manage Connected Boxes, and Create from that Spark. * Trash and Stats controls focus on the data shown in those screens. ## View Controls View Controls change how the current screen is displayed. Use them for options such as filtering, sorting, split view, preview size, list or feed display, and other view settings. ## Tips and Toast Colors MindLi uses three message types in Help, web toasts, and mobile app messages: 1. **Info:** A neutral tip or explanation. 2. **Warning:** Something needs attention before you continue. 3. **Success:** An action finished successfully. This is an info message. Use it for helpful tips, explanations, and neutral reminders.

In the Help Center, we also use this to share "smart" tips.
This is a warning message. Use it when something needs attention, could be risky, or may change what happens next.

In the Help Center, we also use this to point out important limits, risks, or things to check.
This is a success message. Use it when an action is complete or saved.

In the Help Center, we also use this to talk about advanced smart usage of MindLi.
# Welcome Source: https://docs.mindli.com/get-started/welcome MindLi's Help Center MindLi Screen ## Get started Empower your thinking: Add Sparks (input), Box them (process), and Create insights (output). Our Mission} href="/get-started/mission"> The Why, What and How of MindLi The ABC Thinking Steps} href="/get-started/abc-steps"> Start Simple, Continue Smart with the ABC universal thinking steps QuickStart} href="/get-started/quickstart"> Initial setup (Web, iOS, Android and Chrome/Edge extension) Using MindLi} href="/get-started/using-mindli"> Shared principles, global buttons, and common controls Thinking Patterns} href="/get-started/thinking-patterns"> Choose practical patterns for clearer thinking and better outcomes ## Work With MindLi & More Get the best of it. Work With the Main Screens} href="/workwith/home"> Home, Box, Inbox, and Spark More Screens} href="/workwith/trash"> Stats, Trash, and Settings # Add Sparks Source: https://docs.mindli.com/more/add-sparks Add Sparks Settings includes setting the various sensors to capture Sparks. # Advanced Source: https://docs.mindli.com/more/advanced Advanced Settings include advanced features, tips, tricks, and hacks. # General Source: https://docs.mindli.com/more/general General Settings includes Profile, AI, etc. # Settings Source: https://docs.mindli.com/more/settings Configure MindLi to fit your thinking needs. ## Overview Customize MindLi to fit your thinking workflow. It includes the following sections: * ** General:** Profile, preferences, display, version, help, legal, and account management * ** Add:** Configure sensors for capturing Sparks (WhatsApp, Chrome extension, Email) * ** Box:** Automate Box organization and Spark details (Auto Boxing, Auto Name, Auto Cover Image) * ** Create:** Explore AI operations for Sparks, Boxes, and Home * ** Advanced:** Labs features, export data, and experimental options - Settings are saved automatically as you make changes. - Available settings may vary depending on your platform. }>
  1. Start in General to set MindLi in the way that fits you best, especially profile, display, and account preferences, so the app feels aligned with how you think and work each day
  2. When Sparks come in from sensors, MindLi enriches them with AI by default while keeping the original content intact; to keep fully raw input, go to Settings > Box and turn it off
  3. Need a reminder of how MindLi works? Use Redo Onboarding in General to quickly walk through setup again
# Stats Source: https://docs.mindli.com/more/stats View your thinking statistics, patterns, and experimental analytics. > “I think; therefore I am.” > René Descartes 1596–1650 (French philosopher, mathematician, and scientist, often referred to as the "Father of Modern Philosophy.") ## Overview * Our roadmap for "human thinking in the age of AI" draws from how people use MindLi. * Here, we share various experimental statistics on your thinking. * Share your feedback through the Help menu. For shared actions across MindLi, including the MindLi button, Help button, Avatar button, and Search field, see [Using MindLi](/get-started/using-mindli). ## Stats Screen Controls 1. ** Stats:** Refresh data to get the latest statistics 2. ** Sparks:** View the 4 oldest Sparks in a selected Box, adjust preview size, and show/hide archived Sparks }>
  1. Use Sparks > Show Oldest Sparks in a Box to resurface long-running topics and decide what to archive or reconnect
  2. Use Sparks > Show Archived to confirm cleanup is not hiding important patterns
# Thinking workflows plan Source: https://docs.mindli.com/plans/thinking-workflows-plan # Thinking Workflows Page Plan Date: 2026-May-28 Status: Draft for review ## 1. Goal Add a cross-functional docs hub for pages that teach people how to use MindLi to think better across multiple screens and features. This should not become a new top-level docs section yet. It should be a page under `More`, placed as the last item, and that page can lead to deeper workflow pages over time. ## 2. Recommended Name Use: `Thinking Workflows` Why: * It is task and outcome oriented, not screen oriented. * It clearly fits cross-functional topics such as capture, clarify, organize, research, plan, review, write, and decide. * It works for both human readers and AI agents because the word `Workflows` signals goal-based guidance. * It does not conflict with existing `Quick Tip` and `Smart Tip` callout naming. Avoid: * `Workflows` alone, because it is too generic. * `Smart Tips`, because that is already an in-page callout pattern. * A product-object name such as `Spark`, `Box`, or `Home`, because this content should cross product areas. ## 3. Recommended Location Place it under `More` as the last item. Expected page path: `more/thinking-workflows.mdx` Expected docs URL: `/more/thinking-workflows` Suggested nav shape: ```text theme={null} More - General - Add Sparks - Settings - Stats - Advanced - Thinking Workflows ``` ## 4. Page Purpose The page should act as a hub, not a long reference page. It should explain: * Use `Work with MindLi` pages when the reader needs screen-by-screen help. * Use `Thinking Workflows` when the reader has a real thinking task and needs to move across screens. * Use linked workflow pages for deeper step-by-step guidance. ## 5. Suggested Hub Intro Draft intro: ```text theme={null} Use these guides when you want to use MindLi across screens to think through real work, not just learn one button or one page. ``` ## 6. Initial Workflow Topics Start with a small set of workflow links. Each linked page can be added later. ```text theme={null} Capture Ideas Clarify a Spark Organize with Boxes Build a Research Trail Plan a Project Review and Refine Ideas Prepare to Write Make a Decision ``` ## 7. AI Agent Guidance This page should be useful as an AI retrieval hub. Recommended rule: ```text theme={null} If the user asks how to accomplish a thinking task, start from Thinking Workflows. If the user asks where a button or control is, start from Work with MindLi. ``` This keeps the documentation split clean: ```text theme={null} Thinking Workflows = goal-based guides Work with MindLi = screen and control reference Quick/Smart Tips = local in-page advice ``` ## 8. Implementation Plan 1. Add `more/thinking-workflows.mdx`. 2. Add it as the last item in the `More` group in `docs.json`. 3. Keep the first version as a hub page with short link cards or concise sections. 4. Add deeper pages only after the hub wording feels right. 5. Reuse existing docs conventions for callouts: * `Note` for neutral guidance. * `Check` for helpful success-oriented tips. * Avoid `Warning` in MindLi-authored docs content. ## 9. Open Questions 1. Should the first version link to placeholder pages, or only list topics until each page exists? 2. Should the hub title be exactly `Thinking Workflows`, or should the visible nav label be shorter? 3. Should the first deeper workflow be `Capture Ideas` or `Clarify a Spark`? # Create Plant Source: https://docs.mindli.com/samples/api-reference/endpoint/create POST /plants Creates a new plant in the store # Delete Plant Source: https://docs.mindli.com/samples/api-reference/endpoint/delete DELETE /plants/{id} Deletes a single plant based on the ID supplied # Get Plants Source: https://docs.mindli.com/samples/api-reference/endpoint/get GET /plants Returns all plants from the system that the user has access to # Introduction Source: https://docs.mindli.com/samples/api-reference/introduction Example section for showcasing API endpoints If you're not looking to build API reference documentation, you can delete this section by removing the api-reference folder. ## Welcome There are two ways to build API documentation: [OpenAPI](https://mintlify.com/docs/api-playground/openapi/setup) and [MDX components](https://mintlify.com/docs/api-playground/mdx/configuration). For the starter kit, we are using the following OpenAPI specification. View the OpenAPI specification file ## Authentication All API endpoints are authenticated using Bearer tokens and picked up from the specification file. ```json theme={null} "security": [ { "bearerAuth": [] } ] ``` # Development Source: https://docs.mindli.com/samples/development Learn how to preview changes locally **Prerequisite**: Please install Node.js (version 19 or higher) before proceeding. Step 1. Install Mintlify on your OS: ```bash npm theme={null} npm i -g mintlify ``` ```bash yarn theme={null} yarn global add mintlify ``` Step 2. Go to the docs are located (where you can find `mint.json`) and run the following command: ```bash theme={null} mintlify dev --port 3001 ``` The documentation website is now available at `http://localhost:3001`. ### Custom Ports Mintlify uses port 3000 by default. You can use the `--port` flag to customize the port Mintlify runs on. For example, use this command to run in port 3333: ```bash theme={null} mintlify dev --port 3333 ``` You will see an error like this if you try to run Mintlify in a port that's already taken: ```md theme={null} Error: listen EADDRINUSE: address already in use :::3001 ``` ## Mintlify Versions Each CLI is linked to a specific version of Mintlify. Please update the CLI if your local website looks different than production. ```bash npm theme={null} npm i -g mintlify@latest ``` ```bash yarn theme={null} yarn global upgrade mintlify ``` ## Deployment Unlimited editors available under the [Pro Plan](https://mintlify.com/pricing) and above. You should see the following if the deploy successfully went through: ## Troubleshooting Here's how to solve some common problems when working with the CLI. Update to Node v18. Run `mintlify install` and try again. Go to the `C:/Users/Username/.mintlify/` directory and remove the `mint` folder. Then Open the Git Bash in this location and run `git clone https://github.com/mintlify/mint.git`. Repeat step 3. Try navigating to the root of your device and delete the \~/.mintlify folder. Then run `mintlify dev` again. Curious about what changed in a CLI version? [Check out the CLI changelog.](/changelog/command-line) # Code Blocks Source: https://docs.mindli.com/samples/essentials/code Display inline code and code blocks ## Basic ### Inline Code To denote a `word` or `phrase` as code, enclose it in backticks (\`). ``` To denote a `word` or `phrase` as code, enclose it in backticks (`). ``` ### Code Block Use [fenced code blocks](https://www.markdownguide.org/extended-syntax/#fenced-code-blocks) by enclosing code in three backticks and follow the leading ticks with the programming language of your snippet to get syntax highlighting. Optionally, you can also write the name of your code after the programming language. ```java HelloWorld.java theme={null} class HelloWorld { public static void main(String[] args) { System.out.println("Hello, World!"); } } ``` ````md theme={null} ```java HelloWorld.java class HelloWorld { public static void main(String[] args) { System.out.println("Hello, World!"); } } ``` ```` # Images and Embeds Source: https://docs.mindli.com/samples/essentials/images Add image, video, and other HTML elements ## Image ### Using Markdown The [markdown syntax](https://www.markdownguide.org/basic-syntax/#images) lets you add images using the following code ```md theme={null} ![title](/path/image.jpg) ``` Note that the image file size must be less than 5MB. Otherwise, we recommend hosting on a service like [Cloudinary](https://cloudinary.com/) or [S3](https://aws.amazon.com/s3/). You can then use that URL and embed. ### Using Embeds To get more customizability with images, you can also use [embeds](/writing-content/embed) to add images ```html theme={null} ``` ## Embeds and HTML elements ``` # Markdown Syntax Source: https://docs.mindli.com/samples/essentials/markdown Text, title, and styling in standard markdown ## Titles Best used for section headers. ```md theme={null} ## Titles ``` ### Subtitles Best use to subsection headers. ```md theme={null} ### Subtitles ``` Each **title** and **subtitle** creates an anchor and also shows up on the table of contents on the right. ## Text Formatting We support most markdown formatting. Simply add `**`, `_`, or `~` around text to format it. | Style | How to write it | Result | | ------------- | ----------------- | ----------------- | | Bold | `**bold**` | **bold** | | Italic | `_italic_` | *italic* | | Strikethrough | `~strikethrough~` | ~~strikethrough~~ | You can combine these. For example, write `**_bold and italic_**` to get ***bold and italic*** text. You need to use HTML to write superscript and subscript text. That is, add `` or `` around your text. | Text Size | How to write it | Result | | ----------- | ------------------------ | ---------------------- | | Superscript | `superscript` | superscript | | Subscript | `subscript` | subscript | ## Linking to Pages You can add a link by wrapping text in `[]()`. You would write `[link to google](https://google.com)` to [link to google](https://google.com). Links to pages in your docs need to be root-relative. Basically, you should include the entire folder path. For example, `[link to text](/writing-content/text)` links to the page "Text" in our components section. Relative links like `[link to text](../text)` will open slower because we cannot optimize them as easily. ## Blockquotes ### Singleline To create a blockquote, add a `>` in front of a paragraph. > Dorothy followed her through many of the beautiful rooms in her castle. ```md theme={null} > Dorothy followed her through many of the beautiful rooms in her castle. ``` ### Multiline > Dorothy followed her through many of the beautiful rooms in her castle. > > The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood. ```md theme={null} > Dorothy followed her through many of the beautiful rooms in her castle. > > The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood. ``` ### LaTeX Mintlify supports [LaTeX](https://www.latex-project.org) through the Latex component. 8 x (vk x H1 - H2) = (0,1) ```md theme={null} 8 x (vk x H1 - H2) = (0,1) ``` # Navigation Source: https://docs.mindli.com/samples/essentials/navigation The navigation field in mint.json defines the pages that go in the navigation menu The navigation menu is the list of links on every website. You will likely update `mint.json` every time you add a new page. Pages do not show up automatically. ## Navigation syntax Our navigation syntax is recursive which means you can make nested navigation groups. You don't need to include `.mdx` in page names. ```json Regular Navigation theme={null} "navigation": [ { "group": "Getting Started", "pages": ["quickstart"] } ] ``` ```json Nested Navigation theme={null} "navigation": [ { "group": "Getting Started", "pages": [ "quickstart", { "group": "Nested Reference Pages", "pages": ["nested-reference-page"] } ] } ] ``` ## Folders Simply put your MDX files in folders and update the paths in `mint.json`. For example, to have a page at `https://yoursite.com/your-folder/your-page` you would make a folder called `your-folder` containing an MDX file called `your-page.mdx`. You cannot use `api` for the name of a folder unless you nest it inside another folder. Mintlify uses Next.js which reserves the top-level `api` folder for internal server calls. A folder name such as `api-reference` would be accepted. ```json Navigation With Folder theme={null} "navigation": [ { "group": "Group Name", "pages": ["your-folder/your-page"] } ] ``` ## Hidden Pages MDX files not included in `mint.json` will not show up in the sidebar but are accessible through the search bar and by linking directly to them. # Reusable Snippets Source: https://docs.mindli.com/samples/essentials/reusable-snippets Reusable, custom snippets to keep content in sync One of the core principles of software development is DRY (Don't Repeat Yourself). This is a principle that apply to documentation as well. If you find yourself repeating the same content in multiple places, you should consider creating a custom snippet to keep your content in sync. ## Creating a custom snippet **Pre-condition**: You must create your snippet file in the `snippets` directory. Any page in the `snippets` directory will be treated as a snippet and will not be rendered into a standalone page. If you want to create a standalone page from the snippet, import the snippet into another file and call it as a component. ### Default export 1. Add content to your snippet file that you want to re-use across multiple locations. Optionally, you can add variables that can be filled in via props when you import the snippet. ```mdx snippets/my-snippet.mdx theme={null} Hello world! This is my content I want to reuse across pages. My keyword of the day is {word}. ``` The content that you want to reuse must be inside the `snippets` directory in order for the import to work. 2. Import the snippet into your destination file. ```mdx destination-file.mdx theme={null} --- title: My title description: My Description --- import MySnippet from '/snippets/path/to/my-snippet.mdx'; ## Header Lorem impsum dolor sit amet. ``` ### Reusable variables 1. Export a variable from your snippet file: ```mdx snippets/path/to/custom-variables.mdx theme={null} export const myName = 'my name'; export const myObject = { fruit: 'strawberries' }; ``` 2. Import the snippet from your destination file and use the variable: ```mdx destination-file.mdx theme={null} --- title: My title description: My Description --- import { myName, myObject } from '/snippets/path/to/custom-variables.mdx'; Hello, my name is {myName} and I like {myObject.fruit}. ``` ### Reusable components 1. Inside your snippet file, create a component that takes in props by exporting your component in the form of an arrow function. ```mdx snippets/custom-component.mdx theme={null} export const MyComponent = ({ title }) => (

{title}

... snippet content ...

); ``` MDX does not compile inside the body of an arrow function. Stick to HTML syntax when you can or use a default export if you need to use MDX. 2. Import the snippet into your destination file and pass in the props ```mdx destination-file.mdx theme={null} --- title: My title description: My Description --- import { MyComponent } from '/snippets/custom-component.mdx'; Lorem ipsum dolor sit amet. ``` # Global Settings Source: https://docs.mindli.com/samples/essentials/settings Mintlify gives you complete control over the look and feel of your documentation using the mint.json file Every Mintlify site needs a `mint.json` file with the core configuration settings. Learn more about the [properties](#properties) below. ## Properties Name of your project. Used for the global title. Example: `mintlify` An array of groups with all the pages within that group The name of the group. Example: `Settings` The relative paths to the markdown files that will serve as pages. Example: `["customization", "page"]` Path to logo image or object with path to "light" and "dark" mode logo images Path to the logo in light mode Path to the logo in dark mode Where clicking on the logo links you to Path to the favicon image Hex color codes for your global theme The primary color. Used for most often for highlighted content, section headers, accents, in light mode The primary color for dark mode. Used for most often for highlighted content, section headers, accents, in dark mode The primary color for important buttons The color of the background in both light and dark mode The hex color code of the background in light mode The hex color code of the background in dark mode Array of `name`s and `url`s of links you want to include in the topbar The name of the button. Example: `Contact us` The url once you click on the button. Example: `https://mintlify.com/docs` Link shows a button. GitHub shows the repo information at the url provided including the number of GitHub stars. If `link`: What the button links to. If `github`: Link to the repository to load GitHub information from. Text inside the button. Only required if `type` is a `link`. Array of version names. Only use this if you want to show different versions of docs with a dropdown in the navigation bar. An array of the anchors, includes the `icon`, `color`, and `url`. The [Font Awesome](https://fontawesome.com/search?q=heart) icon used to feature the anchor. Example: `comments` The name of the anchor label. Example: `Community` The start of the URL that marks what pages go in the anchor. Generally, this is the name of the folder you put your pages in. The hex color of the anchor icon background. Can also be a gradient if you pass an object with the properties `from` and `to` that are each a hex color. Used if you want to hide an anchor until the correct docs version is selected. Pass `true` if you want to hide the anchor until you directly link someone to docs inside it. One of: "brands", "duotone", "light", "sharp-solid", "solid", or "thin" Override the default configurations for the top-most anchor. The name of the top-most anchor Font Awesome icon. One of: "brands", "duotone", "light", "sharp-solid", "solid", or "thin" An array of navigational tabs. The name of the tab label. The start of the URL that marks what pages go in the tab. Generally, this is the name of the folder you put your pages in. Configuration for API settings. Learn more about API pages at [API Components](/api-playground/demo). The base url for all API endpoints. If `baseUrl` is an array, it will enable for multiple base url options that the user can toggle. The authentication strategy used for all API endpoints. The name of the authentication parameter used in the API playground. If method is `basic`, the format should be `[usernameName]:[passwordName]` The default value that's designed to be a prefix for the authentication input field. E.g. If an `inputPrefix` of `AuthKey` would inherit the default input result of the authentication field as `AuthKey`. Configurations for the API playground Whether the playground is showing, hidden, or only displaying the endpoint with no added user interactivity `simple` Learn more at the [playground guides](/api-playground/demo) Enabling this flag ensures that key ordering in OpenAPI pages matches the key ordering defined in the OpenAPI file. This behavior will soon be enabled by default, at which point this field will be deprecated. A string or an array of strings of URL(s) or relative path(s) pointing to your OpenAPI file. Examples: ```json Absolute theme={null} "openapi": "https://example.com/openapi.json" ``` ```json Relative theme={null} "openapi": "/openapi.json" ``` ```json Multiple theme={null} "openapi": ["https://example.com/openapi1.json", "/openapi2.json", "/openapi3.json"] ``` An object of social media accounts where the key:property pair represents the social media platform and the account url. Example: ```json theme={null} { "x": "https://x.com/mintlify", "website": "https://mintlify.com" } ``` One of the following values `website`, `facebook`, `x`, `discord`, `slack`, `github`, `linkedin`, `instagram`, `hacker-news` Example: `x` The URL to the social platform. Example: `https://x.com/mintlify` Configurations to enable feedback buttons Enables a button to allow users to suggest edits via pull requests Enables a button to allow users to raise an issue about the documentation Customize the dark mode toggle. Set if you always want to show light or dark mode for new users. When not set, we default to the same mode as the user's operating system. Set to true to hide the dark/light mode toggle. You can combine `isHidden` with `default` to force your docs to only use light or dark mode. For example: ```json Only Dark Mode theme={null} "modeToggle": { "default": "dark", "isHidden": true } ``` ```json Only Light Mode theme={null} "modeToggle": { "default": "light", "isHidden": true } ``` A background image to be displayed behind every page. See example with [Infisical](https://infisical.com/docs) and [FRPC](https://frpc.io). # Boxes Source: https://docs.mindli.com/views/boxes In Boxes View you get all your Main and sub Boxes. > "Before you can think out of the Box, you have to start with a Box." > — Twyla Tharp 1941- (Dancer and author, "The Creative Habit: Learn It and Use It for Life") * Set and Manage your thinking in Boxes based on topics, projects, or other methods. * Set your Main Boxes for your main level thinking, arrange and reorder your thinking in Sub-Boxes. * Revisit Boxes view to update your goals priorities, and order. # Sparks Source: https://docs.mindli.com/views/sparks In Sparks View you get a feed view of your Sparks. > "From a small spark may burst a mighty flame" > — Dante Alighieri 1265–1321 (Italian poet, writer, and philosopher, best known for the poem, "The Divine Comedy") * Explore your added Sparks in Inbox (red badge). * See your Pinned Sparks from your Boxes. * Tip: use text search in All sub-view. # Box Source: https://docs.mindli.com/workwith/box View, edit, and work with a specific Box
## Overview A Box is a container that holds related Sparks and can also contain Sub-Boxes. It helps you organize your thoughts and information in a structured way. A Box has a name and description. It can be placed under one Parent Box, and it can contain other Sub-Boxes. For shared actions across MindLi, including the MindLi button, Help button, Avatar button, and Search field, see [Using MindLi](/get-started/using-mindli). Smart Tip: Use Bulk Actions when you want to organize several Sparks at once. After you select Sparks, you can: * Connect them to other Boxes * Move them * Archive them * Send them to Trash ## Box Screen Controls 1. ** Box:** Manage Box settings, view options, search, edit details, star/unstar, move to trash, export, and manage sharing 2. ** Sparks:** View Sparks in this Box, create new Sparks, and select multiple Sparks for bulk actions 3. ** Sub-Boxes:** View Sub-Boxes within this Box and create new Sub-Boxes 4. ** Create:** Generate AI-powered insights across all Sparks in this Box ## Box View Controls ### Sparks 1. ** Sort:** Change the order of Sparks in this Box 2. ** List View:** Show Sparks in a compact list 3. ** Feed View:** Show Sparks as larger preview cards ### Sub-Boxes 1. ** Filter:** Choose which Sub-Boxes appear in this Box 2. ** Sort:** Change the order of Sub-Boxes in this Box 3. ** Spark Preview:** Choose how much Spark preview content appears under Sub-Boxes 4. ** Level:** Choose how many Sub-Box levels are expanded in this Box }>
  1. Name Boxes with extra detail so they’re easy to spot later (for example, "Trip to Greece" instead of "Trip")
  2. Duplicate Box names are allowed, but not recommended
# Home Source: https://docs.mindli.com/workwith/home In the Home screen you get a panoramic view of your Sparks and Boxes. > “Home is the nicest word there is.” > — Laura Ingalls Wilder 1867–1957 (American writer best known for her "Little House on the Prairie" series) ## Overview You start and come back to this Home screen where you can view all your Sparks and Boxes. **Tip:** 1. Look for the red badge to access your Inbox, and digest Sparks that were added recently. 2. You can open a Box by clicking the ">" arrow to view its Sparks and Sub-Boxes. For shared actions across MindLi, including the MindLi button, Help button, Avatar button, and Search field, see [Using MindLi](/get-started/using-mindli). ## Home Screen Controls 1. ** Home:** View home presets, settings, and refresh data 2. ** Sparks:** Go To Spark, Create New Spark in your Inbox or in a selected Box 3. ** Boxes:** Go To Box, Create New Box in Home or in a selected Box 4. ** Create:** Create AI-powered insights across all your Boxes ## Home View Controls 1. ** Filter:** Choose which Boxes and Sparks appear on Home 2. ** Sort:** Change the order of Boxes on Home 3. ** Spark Preview:** Choose how much Spark preview content appears under Boxes 4. ** Level:** Choose how many Box levels are expanded on Home }>
  1. Use Home menu > My Focused Home... to save a Chosen Focus (arrangement, filters, sort order, Spark preview settings) and restore it when you want that exact workspace back
  2. Use Home filters to switch between individual, group, and public boxes so you can isolate one view without changing the underlying structure
# Inbox Source: https://docs.mindli.com/workwith/inbox Review all your added Sparks from all sensors ## Overview * The Inbox is a special kind of Box that collects all the added Sparks * You can use all the usual Box actions Tip: You cannot edit or delete "My Inbox" since it is your default Box. Quick Tip: * Try to keep your Inbox organized by regularly reviewing and processing added Sparks. For shared actions across MindLi, including the MindLi button, Help button, Avatar button, and Search field, see [Using MindLi](/get-started/using-mindli). ## Inbox Screen Controls 1. ** Box:** View Inbox details, access view options, search, and refresh data 2. ** Sparks:** View Sparks in the Inbox, create new Sparks, and select multiple Sparks for bulk actions 3. ** Sub-Boxes:** View Sub-Boxes within the Inbox and create new Sub-Boxes 4. ** Create:** Generate AI-powered insights across all Sparks in the Inbox ## Inbox View Controls ### Sparks 1. ** Sort:** Change the order of Sparks in the Inbox 2. ** List View:** Show Sparks in a compact list 3. ** Feed View:** Show Sparks as larger preview cards ### Sub-Boxes 1. ** Filter:** Choose which Sub-Boxes appear in the Inbox 2. ** Sort:** Change the order of Sub-Boxes in the Inbox 3. ** Spark Preview:** Choose how much Spark preview content appears under Sub-Boxes 4. ** Level:** Choose how many Sub-Box levels are expanded in the Inbox }>
  1. Create an **Other** or **Later** Box and move low-priority Sparks in batches to keep the Inbox scan-friendly
  2. Archive Sparks you do not need right now, but wish to store for future reference
  3. Use Settings > Box > Auto Disconnect from My Inbox to remove Sparks from the Inbox when you connect them to other Boxes, keeping it clear for new captures
# Spark Source: https://docs.mindli.com/workwith/spark View, edit, and Create with a specific Spark ## Overview The Spark is the core unit of thought in MindLi. It can be a note, an image, a file, a voice message, a link, or any other piece of information you want to capture and work with. A Spark has an image, title, content, and can be connected to one or more Boxes. The image (see Spark > Spark view > details) is designed to give you a quick visual cue about the Spark content. **Tip:** 1. Use the Spark's image to quickly identify the type or topic of the Spark. 2. Update the cover image by uploading a new one, pasting from clipboard, or letting Create suggest one for you. For shared actions across MindLi, including the MindLi button, Help button, Avatar button, and Search field, see [Using MindLi](/get-started/using-mindli). ## Spark Screen Controls 1. ** Spark:** View Spark details, edit in quick-edit mode, duplicate, pin, star, archive, and manage Spark actions 2. ** Boxes:** Edit which Boxes this Spark connects to and get AI-suggested Boxes 3. ** Create:** Generate new content based on this Spark ## Spark View Controls 1. ** Spark Filter:** Choose which Spark sections are shown, such as Basics, Basics + Details, or Info 2. ** Split View:** Show the Spark only, the Spark with its attachment, or the attachment only For a full guide with modes, use cases, and Chrome extension requirements, see [Split View](/get-started/patterns/split-view). }>
  1. Use Split View to read the source and edit side-by-side — see the full [Split View guide](/get-started/patterns/split-view)
  2. Use Create to generate summaries, next steps, or rewrites from the current Spark when you need a quick digest
# Trash Source: https://docs.mindli.com/workwith/trash View, delete, or restore Sparks or Boxes that were moved to the Trash. ## Overview The Trash is where Sparks and Boxes go when you move them to the Trash. Here you can: * View the Spark or Box that was deleted * Restore it to its original location (or Inbox/Home if original location not available) * Permanently delete it Deleting a Spark or Box from the Trash is permanent and cannot be undone. For shared actions across MindLi, including the MindLi button, Help button, Avatar button, and Search field, see [Using MindLi](/get-started/using-mindli). Smart Tip: Unlike file system folder trash, in MindLi, moving a Box to Trash does not move its Sub-Boxes to Trash with it. The Sub-Boxes move up one level and stay connected to the parent Box above it. This helps keep useful Sub-Boxes available when you remove one Box. ## Trash Screen Controls 1. ** Trash:** Refresh trash data to get the latest list of deleted items 2. ** Sparks:** View trashed Sparks, select for bulk actions, restore all, or empty Sparks trash 3. ** Boxes:** View trashed Boxes, restore all, or empty Boxes trash }>
  1. Use Trash > Search to find deleted items by summary, description, or related Box name when a title does not come to mind
  2. Open Sparks > Select for Bulk Actions to restore or delete many items at once when you are cleaning up at scale