Base44 Release Notes

Learn how you and your Superagent share notes

Create and edit notes, keep them updated from your email, calendar, and chats, and share them with a public link.

Notes is a shared space where you and your Superagent keep the information you both work from. Your Superagent creates and updates notes as it learns about your work, and you can read them, edit them, and add notes of your own. Open Notes in the sidebar to see them.

Tip: To jump straight to this page, add /notes to the end of your Superagent’s web address, or bookmark the page.

How notes work

Your Superagent organizes what it knows into notes by topic, such as your projects, the people you work with, or your travel plans. Notes link to each other, and each note shows the notes it connects to, so related information stays together. At the top of the list, the pinned For you note tracks your current priorities, anything that needs your attention, and your upcoming calendar items.

The Notes list, with the pinned For you note at the top

When your Superagent references a note in chat, the note opens in a side panel beside the conversation, so you can read it without leaving the chat. You can also attach notes to a message so your Superagent uses them as context.

Reviewing your notes

Read through what your Superagent knows, starting from the For you note.

To review your notes:

1. Open your Superagent.
2. Click Notes in the sidebar.
3. Click a note to open it, or click the search icon to find one by name.

Opening a note from the Notes list

Creating a note

Add your own notes alongside the ones your Superagent creates. Write one from scratch, or keep something your Superagent has already told you.

Writing a note yourself

Start a blank note and build it out with the elements you need.

To create a note:

1. Open your Superagent.
2. Click Notes in the sidebar.
3. Click Add new note.
4. Give the note a title, then type its content. Notes save automatically as you write.
5. Press / or click the Add block button to add elements such as headings, lists, images, and tables.

Adding an element to a note from the add block menu

Saving part of a conversation

Keep something your Superagent said without retyping it.

To save a selection as a note:

1. In your Superagent conversation, highlight the text you want to keep.
2. Click Add note.
3. Click View note in the confirmation to open it.

Saving a highlighted passage from a conversation as a note

Everything you save from the same conversation goes into one note, so highlighting another passage later adds to that note instead of starting a new one.

Adding a kanban board to a note

A note can hold a live kanban board, so you can track work in the same place you and your Superagent keep everything else. A board is text underneath, where each column is a heading and each card is a list item, so you can build it visually or write it out.

A kanban board inside a note, with Todo and Done columns

To add a board:

1. Open the note, then click in its body where you want the board.
2. Press / or click the Add block button, then select Kanban board. The board starts with a Todo and a Done column.
3. Build it out:
   • Add a card: Click Add card in a column, then type the card text.
   • Add a column: Click Add column to the right of the board, or select Add column after from a column’s menu. A new column arrives titled New column with your cursor at the end of it, so clear that text before typing your own title.
   • Move a card: Drag it to another column, or select Move to from the card’s menu.
   • Rename or reorder a column: Select Rename column, Move left, or Move right from the column’s menu.
   • Remove something: Select Delete card or Delete column.
   • Edit it as text: Click Show raw text on the board, then Hide raw text to go back to the board.

A board also appears in a note you share to the web, laid out and ready to read.

Keeping your notes up to date

Your Superagent keeps notes current as you chat with it. You can also refresh them from your connected data at any time.

To refresh your notes:

1. Open your Superagent.
2. Click Notes in the sidebar.
3. Click Update notes.
4. Click Refresh data. Your Superagent reviews your available email, calendar, and conversation data and updates your notes.

Confirming a refresh of your notes from your connected data

Managing a note

Duplicate, share, or delete a note from its More actions menu. The note’s row in the list has a quick menu for duplicating and deleting, and the open note has the full menu, including sharing.

To manage a note:

1. Open your Superagent.
2. Click Notes in the sidebar.
3. Open the note, then click the More actions icon at the top right.
4. Do one of the following:

Managing a note from its More Actions menu

• Duplicate a note
• Share a note to the web
• Delete a note

Opening notes beside your chat

Open the notes panel yourself at any time, without waiting for your Superagent to reference a note. The panel docks beside your conversation, so you can read a note and keep chatting.

Notes docked beside your conversation

To open notes beside your chat:

1. Open your Superagent.
2. Open a conversation, or click New conversation.
3. Click the Open notes icon at the top right.

Note: From the docked panel, you can:

• Open a note: Click it in the panel’s list.
• Switch notes: Click the note title at the top of the panel, then select another note, or select All notes to go back to the list.
• Read a note in full: Click the More actions icon, then select Open full page.
• Close the panel: Click the Close note icon, or click the Open notes icon again.

FAQs

Click a question below to learn more about notes.

• What is the difference between notes and memory?
• What is the difference between notes, files, and data?
• Who can see my notes?
• Where do meeting notes go?

Original source

Connect your app to popular tools like Google Workspace, Slack, Salesforce, GitHub, Snowflake, and Databricks using managed integrations.

Connectors let your Base44 app work with the tools and data your business already uses. Connect services like Gmail, Slack, Google Workspace, Snowflake, Databricks, and more, then ask the AI chat to help you build app flows that use them.

About connectors

Connectors link your app to the tools you already use. Pick a tool, authorize it, and let Base44 handle the setup behind the scenes, no API keys, no manual config.

Tip

Need more control over a specific API? Use a custom integration.

Connector types

There are two types of connector, based on whose account the connection uses.

Connectors for app users

Each person using your app connects their own account. The app acts on their behalf, and their data stays private to them.

Best for per-user actions, like a CRM where each sales rep sends email from their own Gmail.

Connectors for app builders

You connect a tool once at the workspace level, and the app uses that one connection for everyone.

Best for a shared account or a data platform, like Slack alerts to your team’s channel, or a dashboard that queries Snowflake.

Browsing available connectors

Find connectors in the Integrations tab of your app’s dashboard. Search for a specific connector or use the filter to sort the list.

You can also tell the AI chat what you want to connect and how you want to use it, and get relevant suggestions based on your app’s structure, pages, and data.

To browse the full list with categories and example prompts, see the connectors catalog.

Send reports and alerts

Email reports, alerts, or summaries through Gmail or Outlook.

Generate documents and files

Create documents, spreadsheets, presentations, or files using Google Workspace tools.

Manage events and availability

Create and manage events or availability using Google Calendar or Outlook.

Notify your team

Send notifications or updates to teams through Slack.

Track code and issues

Track code activity, issues, and pull requests with GitHub.

Query data and build dashboards

Query external data and build dashboards with Snowflake or Databricks.

Request a connector

You can also request a connector to add to Base44. Go to Integrations in your app’s dashboard and click Request a connector at the bottom.

How connectors work in your app

Once you connect a tool, you can reuse it across pages, flows, and backend functions. In the AI chat, ask Base44 to build pages, tables, dashboards, or automations that read from or write to the connector.

When you include a connector in a flow, Base44 creates a backend function in Dashboard → Code → Functions. Open that function to review the generated code. You can edit it yourself or prompt the AI chat to update it. For example:

Send a Slack message to #product-updates when this function runs.

If you later add a flow that needs extra permissions, you may be asked to review and approve the new actions and permissions for that tool.

Registering callback URLs

When you set up a connector with your own OAuth credentials, you register a callback URL with your OAuth provider so it knows where to send people back after they authorize. Base44 uses one callback URL for every app in your workspace.

Using the single callback URL

Every connector you add uses one callback URL for all of your apps, so you register it with your OAuth provider once and it keeps working as you build more apps and connect custom domains.

Add this URL to your OAuth provider’s allowed redirect URIs:
https://connectors.base44.com/api/oauth/callback

Viewing your callback URLs

You can check the single callback URL at any time, and look up the per-app URLs for a specific app.

To view your callback URLs:

1. Click your workspace name at the bottom left.
2. Click Settings.
3. Click Connectors under Plugins.
4. Under Connectors For App Users, click View redirect URIs for your apps.
5. Find the single callback URL under Callback URL.
6. (Optional) Expand Per-app URLs (for legacy connectors), then select an app to see its per-app URLs.

Switching an older connection

Connections you added before August 17, 2026 register a separate URL for each app host, and they show a Per-app URLs badge next to their name. Each connection is switched over on its own, so one connector can have some connections on the single callback URL and others still on per-app URLs.

Switching is worth doing if you are adding apps or custom domains and are tired of registering a new URL each time. If your setup is stable and working, there is no need to switch. Existing connections keep working on their per-app URLs for as long as you leave them there.

Warning

Keep your existing per-app callback URLs registered with your provider when you switch. App users who connected before the switch still need them, and changes in your provider can take a few minutes to take effect.

To switch a connection to the single callback URL:

1. Click your workspace name at the bottom left.
2. Click Settings.
3. Click Connectors under Plugins.
4. Under Connectors For App Users, next to the connector, click View.
5. Under Connections, next to the connection you want to switch, click Edit.
6. Under Callback URLs, click Switch to a single URL.
7. Add the URL shown to your OAuth provider’s allowed redirect URIs.
8. Select I’ve added the URL to my OAuth provider, then click Switch.

Note

To move a connection back later, open it again and click Switch back to per-app URLs. Check that your provider still has the per-app URLs registered first, because a connection created on the single callback URL may never have had them.

Managing your connectors

From Integrations in your app’s dashboard, you can view and manage your app’s connectors, review what each can access, and switch, disconnect, or reconnect the connected account per tool as needed.

For connectors for app builders, reconnect from Integrations → My integrations. For connectors for app users, each person reconnects their own account from inside your app.

To manage a connector:

1. Go to your app’s dashboard.
2. Click Integrations.
3. Click the My integrations tab.
4. Find the connector.
5. Click the More actions icon (···) and choose an option:
   • View access to see the connector’s current permissions.
   • Switch account to connect a different account.
   • Reconnect to restore an expired connection.
   • Disconnect to remove the connection from this app.
   • Remove to delete the connector.

Controlling workspace availability

The steps above manage the connectors in one app. On the Enterprise plan, workspace owners and admins can also decide which external services are available across the whole workspace, so a connector you disable is blocked everywhere it is used, including in apps, Superagents, and in-app agents.

You can review which apps rely on a connector before you disable it, and you can allow or block several connectors at once. The two credential types are managed separately, so a service can stay enabled as a Shared Credential while being disabled as an App User Credential.

For the steps, see Managing connector availability for your workspace.

FAQs

Common questions about connecting tools to your app.

Can I connect multiple tools to my app?

Why do I need to reconnect a connector?

Original source

About the template marketplace

Explore ready-to-use app templates from the Base44 community and your workspace. Find inspiration, launch your next project in minutes, or publish your own.

The template marketplace is your shortcut to building great apps on Base44. Browse a wide range of ready-made templates created by talented creators in the community. If you are unsure where to start or want to skip hiring a partner, templates make it easy to get going right away. Just choose a template and customize it to fit your needs.

If you prefer to keep templates private to your team, you can create workspace templates instead of listing them publicly. Workspace templates reuse your app across a single workspace without appearing in the public marketplace. Learn how to create and manage workspace templates.

You can also publish your own public templates for others to use, reaching a wider audience while showcasing your skills. For internal-only use, keep templates as workspace templates so they are available only to your team.

Accessing templates

Go to App Templates in the Community tab in your workspace to browse all available templates. Templates with reviews display an average rating to help you evaluate them before choosing one.

App Templates include:

• Community: Templates shared by the community and available to all Base44 users.
• Workspace: Templates created and saved by your team. Workspace templates are private to your workspace, and only members of your workspace can see them.

When you use a template, it is copied into your own workspace where you can rename it, change the content, update the design, and modify how it works.

Notes:

• You need to be logged in to your Base44 account to view and use app templates.
• If you want to use a template that uses backend functions, you need to have a Builder plan or higher.

To access app templates:

1. In your Base44 workspace, go to App Templates.
2. Hover over a template and click View details to see more information, images, usage stats, ratings, and reviews.
3. (Optional) Use the Workspace tab to view templates created and saved in your workspace. These templates are only visible to members of your workspace.
4. Click Use Template.

Creating public templates

You don’t need to create something complex to share as a public template. Simple apps, reusable layouts, or creative tools can all be helpful to others. If you have made something useful or fun, you can add it to the community app templates library. You can share your template with the whole Base44 community for free.

Before you start, check that your app qualifies. You need to own the app and have published it at least once, and you need to be an admin of the workspace that owns it. An app you started from someone else’s template cannot be listed again. When someone uses your template, it is copied into their workspace and your original app stays the same.

Before submitting your app, make sure:

• You test it to ensure it works and includes full functionality.
• You add real-looking sample content.
• Your app is secure. Learn more about security and using the security check.

You start a template from your app’s dashboard settings.

To create a public template:

1. Click Dashboard in your app editor.
2. Click Settings.
3. Next to Create App Template, click Create template.
4. Select Public template, then click Continue.
5. Under Basic info, enter a Template name and a Description of what makes your app worth trying.
6. Under Categories, select at least one category that describes your app.
7. Under Template screenshots, click Add screenshot and upload at least 3 screenshots, up to 7.
8. Select the I agree to the Base44 Terms and Marketplace Terms checkbox.
9. Click Create template at the top right.

Screenshot guidelines

• Your first screenshot is the template’s cover and must be 16:9, such as 1920x1080. Use the crop icon if it is not.
• To take fresh captures, click Preview app to open your published app.
• Show your app in action with real-looking data, and use clean, full-screen views.
• Avoid blurry or empty screens.

Improving your listing

If you want your template to stand out, start by focusing on solving a clear problem for others and choosing a catchy title. Add a helpful image and description that show your app in action and make its purpose easy to understand.

The most successful templates have clear and friendly language, and include strong visuals that highlight your app’s value.

Tips for improving your listing

Description:

• Say clearly what your app is for and who it helps
• Use short, friendly sentences
• Avoid overly technical or complex language

Tags and categories:

• Pick tags that describe what your app does (like “productivity” or “social”)
• Avoid adding too many tags

The approval process

After you submit your listing, the Base44 team reviews it to make sure it meets community guidelines. Listings that don’t follow these guidelines may be rejected. If your app is approved, it appears in App Templates for others to discover and use.

Base44 may decline or remove a listing if:

• Spam or broken: The app listing is spam or is not functioning.
• Private setting: The app is set to private, which prevents others from viewing it.
• Community rules violation: The app includes content that breaks community rules.
• Screenshots do not match: The submitted screenshots do not reflect the actual appearance or features of the app.
• Missing security settings: Apps must complete a security check to be eligible for publishing.
• Broken functionality: Some features in the app are not working as intended.
• Invalid or non-compliant app name: The app name uses terms like “template,” version numbers, or other values not allowed by store policy.
• Duplicated app without chat: If your app is a duplicate and does not include chat functionality, please send the original app with chat history.
• Mismatched categories: The categories selected do not match the app’s purpose or functionality.
• App has never been published: Apps must be published at least once before being submitted for review.

Important:

• Final approval depends on Base44’s internal guidelines. The team may remove listings that do not meet broader community quality standards, even if a specific reason is not listed above.
• The approval process may take some time. We appreciate your patience.

Updating your template

Your template stays linked to the app you created it from, so what you need to do depends on what changed.

• App functionality or design: Publish your app as usual. Anyone who uses your template from then on gets the latest version, and you do not need to resubmit it.
• Listing details: Changes to the name, description, categories, or screenshots go back through review before they appear in the catalog.

Either way, people who already added your template keep their own copy, and your changes do not reach it.

To update your listing:

1. Click Dashboard in your app editor.
2. Click Settings.
3. Next to App Template, click Submit Update.
4. Make your changes to the listing.
5. Click Submit Update to confirm.

You cannot submit another update while a previous one is still in review.

Managing your listings

From your app’s dashboard you can manage your template listing.

To manage a template listing:

1. Go to your app’s editor.
2. Click Dashboard.
3. Click Settings.
4. Click App Template.
5. Choose what you want to do:
   • See your app in the marketplace: Click the More Actions icon and click See on App Templates.
   • Remove your template from the marketplace: Click the More Actions icon and click Remove from App Templates.

FAQs

Click a question below to learn more.

• Can I still sell my templates?
• Can I see how many people used my template?
• Can I publish multiple templates?
• Where can I see all my template listings?
• If I remove my template listing, does it affect people who already used it?
• Can I share a template with only my workspace?
• What happens if my template has backend functions and secrets?
• What happens if my template uses paid third-party integrations or APIs?
• Can I limit the number of apps a user can create from my template?

Original source

How comments work

Comments live in your app editor’s preview. Each comment is pinned to the element you click and starts a thread where your collaborators can reply, react, and resolve.

Everyone who can edit the app sees the same comments, and new activity appears for all of you in real time. Comments stay anchored to their element as your app changes, so a thread you start today still points at the right spot after your next build.

Tip

Comments are only visible inside the app editor. People using your published app never see them.

To turn on comments, click the Comments icon at the top right of your app editor, next to your avatar.

Turn comments on and off from the top right of your app editor

Adding a comment

Add a comment by pointing at the exact element you want to talk about.

Writing your comment

Base44 captures a screenshot of the spot you click, and you can mention collaborators or add emoji as you write.

To add a comment:

1. Click the Comments icon to turn on comments.
2. Click the element you want to comment on. Base44 drops a pin and captures a screenshot of that part of the page.
3. Type your comment.
   • To mention a collaborator, type @ or click the Mention someone icon, then choose them from the list.
   • To include an emoji, click the Add emoji icon.
4. Click the send icon or press Enter to post it.

Write your comment on the element you clicked

Editing a comment

You can rewrite comments you posted yourself.

To edit a comment:

1. Open the thread and hover over your comment.
2. Click the More Actions icon and select Edit.
3. Change your text, then confirm.

Edit sits under the More Actions icon on your own comments

Editing the screenshot

If the captured screenshot doesn’t frame the right area, you can re-crop it on comments you created. Moving the frame also moves the comment’s pin to the element under it.

To edit a comment’s screenshot:

1. Open the thread, hover over the screenshot, and click Edit.
2. Drag the frame over the area you want to capture.
3. Click Save screenshot area.

The Edit button appears over the screenshot when you hover

Working with comment threads

A pin shows the avatars of everyone in the conversation. Click it to open the thread, or hover over it for a quick preview. In a thread you can:

• Reply: Continue the conversation under the original comment.
• React: Hover over a comment and click the Add reaction icon.
• Resolve: Click the More Actions icon and select Resolve to mark the thread as handled. Resolved threads leave the preview and the default list, and you can unresolve a thread to bring it back.
• Delete: Remove a reply you wrote, or select Delete thread under the More Actions icon to remove the entire thread. Deleting a thread removes it for everyone and can’t be undone.

A thread keeps the whole conversation in one place

Sending comments to the AI chat

Instead of handling feedback yourself, hand it to Base44. Sending a thread to the chat asks Base44 to read the comment, look at its screenshot, and act on it.

Tip

What happens when you send a comment:

• The thread appears in your chat as a comment card that tracks its status live, and you can click View thread on the card to jump back to the comment.
• Base44 adds a 👀 reaction to the comment while it works. If the comment asks a question, Base44 answers inside the thread without changing your app. If it asks for a change, Base44 builds it and replies in the thread when it’s done.
• Sending a comment doesn’t resolve it, so you decide when the thread is closed.

Sending a comment

You can hand a single thread to Base44 right from the comment.

To send a comment to the chat, do one of the following:

• Mention @Base44 in a comment or reply.
• Open the thread and click the Send to chat icon.

Sending several comments

You can send up to 20 threads to the chat as a single request, and Base44 works through them one by one.

To send a batch of threads:

1. In the comments panel, click the More Actions icon and select Send to chat.
2. Select the threads you want to include, or check Select all threads.
3. Click Send threads. The button shows how many threads you selected.

Browsing all comments

The comments panel collects every thread across your app, so nothing gets lost between pages.

When comments are turned on, a sidebar sits along the right edge of the preview, showing the people who commented. Hover over the sidebar to open the panel, where you can:

• Search: Find comments by their text or author.
• Filter: Click the filter icon to show only comments on the Current page, or only Unread ones.
• Resolve: Hover over a comment and click the Resolve icon to close its thread without opening it.
• Show resolved: Click the More Actions icon and turn on Show resolved to see handled threads, or select Mark all as read to clear your unread indicators.
• Jump to a comment: Click any comment to open its pin, even when it lives on another page.

Tip

A dot on the Comments icon means there’s activity you haven’t read yet.

FAQs

Here are answers to common questions about comments.

Original source

Let your Superagent join meetings with a video link, record them, and deliver the meeting notes and action items to its notes library and your email afterward.

Your Superagent can join your meetings as a notetaker. It records the meeting, writes up the notes and action items, saves them to its notes library, and emails them to you when the meeting ends. It works with meetings on your connected calendar that have a video link, such as Google Meet or Zoom.

Your Superagent lines up the meetings it will join and record

Tip: To jump straight to this page, add /meetings to the end of your Superagent’s web address, or bookmark the page.

Connecting your calendar

Your Superagent finds your meetings through the calendar you connected when you created it, either Google Calendar or Microsoft Outlook. Because it reuses that connection, there is no extra sign-in.

To connect your calendar:

1. Open your Superagent.
2. Click Meetings in the sidebar.
3. Click Use my Google calendar or Use my Microsoft calendar, depending on the account you set up with.

Note: Microsoft Outlook works only when you granted calendar access while setting up your Superagent. You cannot connect an Outlook calendar from the Meetings panel afterwards. If you set up with Google, your Superagent uses Google Calendar.

Choosing which meetings to record

Once your calendar is connected, your Superagent joins your meetings automatically. You can turn this off and send it into specific meetings instead.

To choose which meetings your Superagent records:

1. Open your Superagent.
2. Click Meetings in the sidebar.
3. Turn the Join and record my meetings automatically toggle on or off. When it is off, your Superagent stops joining new meetings, and your existing notes stay in your library.
4. To send your Superagent into a specific meeting, click Join next to the meeting.

Turning on automatic joining and recording

Reviewing your meetings and notes

When a meeting ends, its notes and action items are delivered to your Superagent’s notes library and your email. Meetings without a video link do not appear in the list.

Checking the status of each upcoming and recent meeting

To review your meetings:

1. Open your Superagent.
2. Click Meetings in the sidebar.
3. Check each meeting’s status under Upcoming meetings and Recent meetings:

• Scheduled: An upcoming meeting with a video link that your Superagent plans to join.
• Join: Appears close to the start time. Click it to send your Superagent into the meeting.
• Joining: Your Superagent is connecting to the meeting.
• Waiting to be admitted: Your Superagent is in the waiting room. Let it in to start the notes.
• In meeting: Your Superagent has joined.
• Recording: The meeting is in progress and your Superagent is taking notes.
• Processing: The meeting ended and your Superagent is writing up the notes.
• Notes sent: The notes are ready and in your email. Click Notes to read them.
• Failed: Your Superagent could not join or could not finish the notes. Try sending it into the next meeting.

Managing your calendar connection

Reconnect your calendar if it stops syncing, or disconnect it to stop your Superagent from seeing your meetings.

To manage the connection:

1. Open your Superagent.
2. Click Meetings in the sidebar.
3. Click the More actions icon next to Connected with Google.
4. Select Reconnect or Disconnect.

Reconnecting or disconnecting the calendar your Superagent uses

FAQs

Click a question below to learn more about meeting notes.

Can I use Outlook or another calendar?

Original source

Work on several branches alongside your main app

Create branches to try new ideas, features, or redesigns without affecting your app, work on several in parallel, then merge each one into main when ready.

Branches let you try new ideas, features, or redesigns without affecting your app. Each branch has its own chat and its own live preview, and you can work on several branches in parallel, then merge each one into your app when you are happy with the result.

Ways to use a branch

Test a redesign. Try a new look for your app and compare it with the current version. If you change your mind, leave the branch behind.

Keep your live app ready. When a small fix comes up mid-project, fix and publish it from main right away. Your bigger work in progress stays safely on its branch.

Build a feature that launches later. Work ahead of a release and keep the feature on a branch until launch day.

Work in parallel. Build on several branches at the same time, and work with your team on different ideas at once, each on their own branch.

Note

Branches work alongside a GitHub connection. Base44 keeps each branch as a real branch in your repository, and you can also build on a branch that is already there.

How branches work

Your app’s main version is called main. When you create a branch, Base44 starts a separate line of work from the current state of main.

Each branch keeps its own chat, live preview, and copy of your app’s design and pages, so changes you make stay on the branch until you merge them. A branch also builds on its own and keeps its own version history, so branches run in parallel and you can return to any earlier point without touching main.

Some things stay shared across main and every branch. Your app’s data is the same live records everywhere, and record changes happen on main. Your connections and automation, including integrations, secrets, automations, workflows, and in-app agents, are shared too, along with your app’s settings, domains, and published version.

Warning

A branch uses your real, live data.

• Records you add, change, or delete while previewing a branch affect the same data your app uses everywhere.
• To experiment without touching your live data, switch your preview to test data while you work. Test data is available on the Builder plan and higher. Learn more about testing your app with test data.

Creating a branch

Describe what you want to build, and Base44 creates the branch, names it from your first message, and starts building right away. Branch names are short, 3 words or fewer, and always in English, whatever language you write in. The name is set automatically, and a branch cannot be renamed.

Tip

Before you begin: If your app was built a while ago, you may need to make one change on main before you can create your first branch. If that applies to your app, Base44 tells you when you try.

To create a branch:

1. In the app editor, click your app’s logo or name at the top of the chat panel.
2. Click Create new branch.
3. Pick one of the suggestions, or type what you want to build in the chat box.
4. Send the message.

Note

Branches always start from main. If you create a branch while you are on another branch, the new branch still starts from main.

Branches work on your phone as well, both in a mobile browser and in the Base44 app. The branch menu appears at the top of the editor as soon as your app has a branch, so create your first branch from a desktop browser, then switch between branches, build, and merge from your phone.

Importing a branch from GitHub

When your app is connected to GitHub, you can build on a branch that already exists in your repository. Base44 works on that branch itself, so your changes and Base44’s go to the same branch in your repository.

To import a branch from GitHub:

1. In the app editor, click your app’s logo or name at the top of the chat panel.
2. Click Import from GitHub.
3. Search for the branch you want, then select it.
4. Click Import.

Note

You import from the repository your app is connected to. A branch you create in Base44 gets a new branch in that same repository.

Working on a branch

While you are on a branch, the branch’s name replaces your app’s name at the top of the chat panel, and a spinning icon shows when the AI is working. You build on a branch the same way you build on main: describe what you want in the chat. Selecting an element and making a visual edit saves to the branch you are on too, the same as your chat changes.

A few things work differently on a branch:

• Merge to main replaces the Publish button. You publish changes from main after merging.
• The preview shows the branch’s version of your app.
• The page URL includes the branch, so you can share a link that opens the app editor on that branch.

Tip

Branches run in parallel. Send a request on one branch, switch to another, and keep building there while the first one finishes. Your app runs up to 5 builds at the same time, so you and your team can move on several ideas at once, each on their own branch.

The branch menu shows which branches are building, so you can check on them as you go.

Actions that happen on main

You do most of your building on a branch, but some actions affect your whole app, not just one branch. Those always happen on main, even while you are working on a branch:

• Publishing your app
• Creating or changing secrets, connectors, automations, workflows, and in-app agents
• Changing your app’s theme settings
• Undoing a message in the chat, or editing and resending one
• Adding a page from Figma
• Asking the AI to add, change, delete, or import records

Note

If you ask for one of these on a branch, Base44 asks you to do it on main or merge the branch first.

Entities on a branch

You can create entities and add fields to entities you already have on a branch, and both are live in that branch’s own preview right away. On an entity you create, you set everything, including its data permissions. On an entity that already exists, additions apply, so keep a new field optional, because your existing records do not have it yet.

Removing an entity or a field, changing an existing field’s type or whether it is required, and changing data permissions happen on main. Make the change there and your branch picks it up right away, with no merge or update needed.

Records are your app’s live data, shared with main, so ask the AI for record changes on main rather than on a branch. Adding, changing, or deleting records yourself while previewing a branch works as it always does, and it changes the same data your app uses everywhere.

Backend functions on a branch

You can add and change backend functions on a branch. The branch gets its own copy of each function you touch, along with the shared files those functions import, so you can update a helper and the function that uses it together. The branch preview calls the branch’s version, and merging the branch deploys it to main. Your app’s first backend function is created on main, and you can work on functions from a branch after that. On an app imported from GitHub, backend changes stay on main.

Code on a branch

The Code tab shows your app’s files as they are on the branch you are on, rather than as they are on main. You can edit them there, and what you save stays in the branch until you merge it.

The files behind your app’s pages, layout, and styling save straight to the branch, so you can try a code change and leave main untouched. Backend function files save to the branch too. See backend functions on a branch for when a change is live in the branch’s preview and when it waits for the merge.

You do not need to keep track of which is which. A few files change your whole app rather than one branch, and Base44 stops the save and tells you where to go instead:

• Entity files: Ask for the change in the branch’s chat, or switch to main. See entities on a branch for what a branch can change on its own.
• Anything that would change your live app: Make the change on main, and your branch picks it up with no merge needed.

Note

Redeploying a backend function replaces the one your live app runs, so it happens on main.

Using version history on a branch

Every version saved on a branch is listed in that branch’s own version history, so you can look back at how the branch developed and return to any earlier point. Restoring a version changes that branch only, and main stays exactly as it is. A merged branch keeps its version history readable, and you can restore while a branch is still active.

To restore an earlier version of a branch:

1. On the branch, click the Version history icon at the top of the chat panel.
2. Click a version in the list to load it in the preview.
3. Click the More options icon next to that version.
4. Click Revert to this version.

Restoring brings the branch’s pages, design, entities, and backend functions back to that version, and the branch’s chat returns to the message that created it. Your records are shared with main, so they stay as they are. Your later versions stay in the list, so you can move forward again whenever you want.

Note

Restoring and publishing from a branch:

• Publish this version is available on main only, because publishing always ships your main app. To release work from a branch, merge it into main and publish from there.
• Restore a version once the branch has finished building and any update from main is complete. If the branch is busy, Base44 tells you so, and you can restore as soon as it finishes.

Switching between branches

You can move between main and your branches at any time, and every branch keeps its changes until you merge it. On a branch, you can also click the X next to Merge to main to exit back to main.

To switch to another branch or back to main:

1. Click the branch name at the top of the chat panel.
2. Select a branch from the list, or select Main chat to return to main.

The icon next to each branch shows its current status. Hover over the icon to see the label:

• Active: The branch is open and ready to build on.
• Working: The AI is building on this branch right now.
• Merging: The branch is being merged into main.
• Merged: The branch was merged into main. Its chat stays readable, but it is read-only.

Note

You can switch branches while the AI is building, and it keeps working on the branch you left. Save or discard any edits on main first.

Updating a branch with changes from main

If main changes while your branch is open, a card appears above the chat box on the branch. It tells you how much changed on main and whether any of it overlaps with your branch.

When you update, the AI combines main’s changes with your branch. If some changes overlap, the AI resolves them for you. If the two versions genuinely conflict, the AI asks you a question in the chat so you can decide what to keep.

To bring main’s latest changes into your branch:

1. On the branch, find the update card above the chat box.
2. Click Update branch.

You can also start an update from the branch menu. Click the More actions icon next to a branch, then click Update from main.

Note

If an update runs into a problem, Base44 rolls it back and your branch’s work stays unchanged.

Merging a branch into main

Merging brings everything you built on the branch into main. Your changes reach your app’s users only when you publish from main, so you decide exactly what goes out and when.

After the merge, a summary of the branch’s changes appears in main’s chat, and the branch stays in your branch list as merged, so you can still read its chat history, but it becomes read-only.

To merge a branch:

1. On the branch, click Merge to main at the top of the editor.
2. Review the confirmation, then click Merge to main.

Tip

You can also ask the AI chat to merge or update a branch. It adds a one-click card to the chat that runs the action for you.

You can also merge from the branch menu. Click the More actions icon next to a branch, then click Merge to main.

Note

If the branch conflicts with changes made on main, Base44 asks you to update it first. Update the branch from main to resolve the conflicts, then merge again.

Deleting a branch

Delete a branch when you are done with an idea and want to clear it from your list. Your app and your other branches stay as they are.

Warning

Deleting a branch is permanent. It removes the branch and its chat, and this cannot be undone. To keep the work, merge the branch into main first.

To delete a branch:

1. Click the branch name at the top of the chat panel.
2. Click the More actions icon next to the branch you want to delete.
3. Click Delete.
4. Review the confirmation, then click Delete branch.

Note

You can delete a branch once the AI finishes building on it and any update from main is complete. Merged branches stay in your list as a record of the work.

FAQs

Click a question below to learn more about branches.

Original source

You can now run any task on a schedule. Once your task is set, just attach a schedule to it. You define exactly when and how often you want your function to run.

Use it to:

• Send daily emails: Keep your users engaged with automated newsletters, digests, or updates.
• Back up your app data: Schedule regular backups to protect valuable information.
• Sync with third-party providers: Keep your data consistent across different platforms.
• Trigger internal maintenance jobs: Keep your app running smoothly with automated clean-up or optimization tasks.

Original source

You can now bring any web library from NPM into your Base44 apps, including GSAP, Radix UI, anime.js, and many more.

These packages cover animation, 3D, UI components, charts, forms, and media, all accessible directly from the builder. Just tell the builder which package you want to use and it will be added automatically.

This unlocks a new level of creativity and functionality. You can build apps with premium motion, advanced 3D scenes, smarter interactions, richer dashboards, file uploads, image editing, and video players, all with more polish and capability.

Original source