What is Brain Pie?
Brain Pie is a visual mind organization tool that uses a 4-layer pie chart to help you organize thoughts, tasks, and actions. Everything stays in your browser by default — no accounts, no servers, no tracking.
The 4-Layer Hierarchy
- Categories — Top-level areas of life (the outer ring). Examples: Work, Health, Personal.
- Slices — Specific domains within a category (the inner pie wedges). Examples: under Health → Exercise, Diet, Sleep.
- Spokes — Individual items radiating outward from slices. These can be reminders, tasks, recurring events, or containers for actions.
- Actions — Sub-items under "List" type spokes. Each action can be scheduled on your calendar independently.
Interacting with the Pie
- Click a slice to expand it to a full 360° view with all its spokes.
- Click a category (outer ring) to see only that category's slices across the full pie.
- Click a spoke to configure it, change its type, or view its actions.
- Click the back button (✕) or anywhere on an expanded chart to return to the full pie.
Privacy First
All data is stored in your browser's localStorage. Nothing is sent to any server unless you explicitly enable Cloud Sync with your own Firebase project. There are no accounts, no cookies, and no analytics.
Adding Categories & Slices
Click the + Add button in the top-right corner to open the Add menu.
- Tab 1 lets you create or select a category, then add slices to it.
- Each slice has a name, weight (percentage), and color.
- Click Done when you've added your slices, or continue to Tab 2 to add spokes.
Adding Spokes
- In Tab 2 of the Add menu, select a slice and type a spoke name into the input field.
- You can also add spokes from the summary cards at the bottom of the page using the green + button.
- New spokes are created as Static type by default. Use the blue "Spoke type" button to change the type.
Editing & Reordering
- Inline editing — Click any spoke name in the summary cards to edit it directly.
- Drag and drop — Drag categories, slices, or spokes to reorder them or move them between groups.
- Percentages — Adjust slice weight percentages to change their visual size in the pie. Other slices automatically redistribute.
- Colors — Use the color picker next to each category or slice to customize colors.
Views
- Pie view — The default circular visualization.
- Treemap view — Toggle the "Treemap" checkbox to see a rectangular grid layout instead.
- Hide spokes — Toggle to show only slices and categories (the pie scales larger).
Spoke Types
Every spoke has a type that determines its behavior:
| Type | Purpose | Calendar? |
|---|
| Static | A persistent reminder — always visible, no scheduling | No |
| Single | A one-time schedulable task — the spoke itself is the event | Yes |
| Repeating | A recurring schedulable task — the spoke itself recurs | Yes |
| List | A container for multiple actions, each independently schedulable | Per action |
Spoke Editor
- Click any spoke on the chart, or its button in the summary cards, to open the Spoke Editor.
- The editor has two tabs: Type and Schedule.
- Use the Type tab to change between Static, Single, Repeating, and List.
- The Schedule tab appears for Single and Repeating types, with fields for date/time or recurrence.
- If a spoke already has a schedule, the editor opens directly on the Schedule tab.
- You can switch types freely — schedule data is preserved if you switch back.
Actions (List Spokes)
- List spokes can have multiple child actions. Click the spoke on the chart to see the action popup.
- Each action has a checkbox to mark it complete (line-through when checked).
- Each action can be independently scheduled on your calendar.
- Use Add & Schedule in the spoke editor to create and schedule an action in one step.
Schedule Indicators
- Scheduled spokes show a green pill with the date/time on the chart.
- When the event is tomorrow, the pill gets a black border.
- When the event is today, the pill gets an orange border.
- When the event has passed, the pill turns orange with a red border.
- Unscheduled schedulable spokes show a blue button in the summary cards.
- Repeating spokes show a compact summary like "Mon, Wed, 5PM".
Calendar Providers
Brain Pie supports two calendar providers, selectable in Settings:
- Google Calendar — Creates events via the Google Calendar API (with sign-in) or opens Google Calendar with pre-filled details.
- Apple Calendar — Downloads an .ics file that opens in Apple Calendar (or any app that supports .ics).
Scheduling Events
- Choose a date, time, and duration in the date/time picker.
- All-day events — Check "All day" to create an event without a specific time. New events default to all-day.
- Duration — Options from 15 minutes to 4 hours.
- Location & Notes — Optional fields included in the calendar event.
- Invitees — Add comma-separated email addresses to invite attendees.
- Click Skip to close without scheduling.
Repeating Events
- Set frequency (daily, weekly, monthly, yearly) and interval.
- For weekly: select specific days of the week.
- For monthly: select the day of the month.
- Choose when to end: never, on a specific date, or after N occurrences.
- Recurring events create proper RRULE entries in Google Calendar and .ics files.
Rescheduling
- Click the green schedule pill on a spoke or action to reschedule.
- The picker pre-fills with the existing schedule.
- Note: You may need to manually delete the old calendar entry if not using Google Calendar API sync.
Calendar Sync (Google)
Sign in with Google in Settings to enable 2-way sync. This allows Brain Pie to create, update, and delete events automatically. If you delete or move an event in Google Calendar, the change syncs back to Brain Pie on page load.
Event Naming
- Single/Repeating spokes: "Spoke Name (Category/Slice)"
- List actions: "Action Name (Spoke/Slice/Category)"
The Priority List
Brain Pie has a built-in priority system to highlight your most important items. The priority list is a ranked order — item #1 is your top priority.
Adding Priorities
- Click the star (★) button next to any spoke or action in the summary cards, action popup, or scheduler overlays.
- Stars turn gold when an item is already prioritised.
- The prioritiser window opens automatically when you add a priority.
The Prioritiser Window
- Toggle with the ★ Priorities button in the top bar.
- Drag the title bar to move the window anywhere on screen.
- Shows the top 5 items by default — click "Show all" to see the full list.
- Drag to reorder items within the list to change their rank.
- Click the star on an item to bump it to position #1 (clicking #1's star removes it).
- Click an item's name to navigate to it on the chart (expands the parent slice and opens the action popup if applicable).
- Click ✕ next to an item to remove it from the list.
Priority Stars on the Chart
- Prioritised spokes show a gold star on the chart (both pie and treemap views).
- Top-5 items get a larger star for extra visibility.
- Click the star on the chart to bump that item's priority.
Automatic Removal
Checking off a completed action (List type) automatically removes it from the priority list.
How Cloud Sync Works
Brain Pie can optionally sync your data across devices using Firebase Realtime Database. You provide your own Firebase project — Brain Pie never stores your data on its servers.
Setting Up
- Go to Settings → Cloud Sync → Enable Cloud Sync.
- Paste your Firebase project config JSON and click "Connect to Firebase".
- Sign in with Google to authenticate.
- On first sync, you'll be asked whether to push your local data to the cloud or start fresh.
Sharing with Other Devices
- After connecting, a shareable URL is generated with your Firebase config encoded in it.
- Open this URL on another device to automatically connect to the same Firebase project.
- You can also export the Firebase config as a JSON file.
Real-Time Sync
Changes sync instantly across all connected devices. The sync indicator in the UI shows connection status.
Offline Fallback
If the Firebase connection is lost, Brain Pie automatically falls back to localStorage. Your data is preserved locally and will sync when the connection is restored.
Google Cloud Setup (for Calendar & Tasks)
Calendar and Tasks features require extra steps in your Firebase project's Google Cloud Console. Without these, calendar and task actions will silently fail.
- Go to console.cloud.google.com and select your Firebase project.
- APIs & Services → Library — search for and enable Google Calendar API.
- In the same Library, search for and enable Google Tasks API.
- APIs & Services → OAuth consent screen — add the Calendar and Tasks scopes, then add your Google account as a test user.
- Firebase Console → Authentication → Settings → Authorised Domains — add the domain where Brain Pie is hosted.
The OAuth consent screen can stay in Testing mode for personal or small-team use. Google verification is only required if you need more than 100 users.
Removing the "Unverified App" Warning
When signing in with Google, users may see a warning that the app is unverified. This is per Firebase project — you can remove it for your own project by submitting your OAuth consent screen for Google verification.
What you'll need before applying:
- A publicly accessible homepage for your app
- A privacy policy page at a verified domain
- That domain verified in Google Search Console
Scope complexity affects how long this takes:
- Basic sign-in only — straightforward review, usually a few days
- Calendar or Tasks scopes — classified as sensitive; requires a full security assessment by Google which can take several weeks
Note: verification applies only to your Firebase project. Other users who set up their own Firebase projects will see the warning for their projects until they complete verification separately.
Exporting Data
- Go to Settings → Export Data & Settings to JSON.
- A selection tree lets you choose which categories, slices, and spokes to include.
- Toggle "Include actions" to export with or without action details.
- Use Select All / Deselect All for quick selection.
- The exported JSON file can be saved as a backup or shared with others.
Importing Data
- Go to Settings → Import and select a JSON file.
- Step 1 — Select: Choose which items to import. Items marked with a link icon (🔗) will merge with existing data of the same name.
- Step 2 — Confirm: Review what will be added or merged before importing.
Smart Merge
Importing uses name-based matching (case-insensitive) to detect existing items:
- Categories with the same name → imported slices are added to the existing category.
- Slices with the same name → imported spokes are added to the existing slice.
- Spokes with the same name → imported actions are added to the existing spoke.
Quick Replace
Use the Replace All button to completely replace your current data with the imported file. This is useful for restoring a full backup.
Scheduled Actions on Import
If imported data contains scheduled actions, calendar events are automatically created during the import process.