BCApps — the home of Business Central application development

BCApps is the single, open collaboration hub for everything Business Central application platform development.

This is where Microsoft engineers, partners, and the wider community build the Business Central application — together, in the open. The Microsoft product team and external contributors work side-by-side in this one repository, on the same code, with the same pipelines and the same tooling.

The source code in this repository is available to everyone under the standard MIT license.

✨ BCApps runs on AL-Go for GitHub — the same build, test, and release automation is available to everyone. ✨

One repository for Business Central

BCApps is now the repository for Business Central application development, consolidating code that used to live in several separate repositories into a single place. It is the single home for:

• the System Application,
• the Business Foundation,
• the Base Application,
• Microsoft's first-party apps (such as E-Documents, Shopify connector, Subscription Billing, Power BI reports, and many more), and
• the developer tools — Test Framework, Performance Toolkit, AI Test Toolkit, and others.

One repo. One workflow. One issues list. One place to collaborate — for Microsoft, for partners, and increasingly for AI agents working alongside them.

Why this matters: GitHub becomes Business Central's business application collaboration platform. It levels the playing field — the same code, pipelines, and tooling Microsoft uses to build the product are available to every partner and community contributor.

Repository structure

All source lives under src, organized by application area. Anything that ships in multiple localizations is split by country/region: a W1 ("worldwide") base plus per-market folders such as DE, US, or GB.

Path	What's inside
src/System Application	The System Application and its modules — the foundational platform layer.
src/Business Foundation	Foundational business logic shared across the application.
src/Layers	The Base Application and Application layers, built per country/region (W1 plus localizations).
src/Apps	Microsoft's first-party apps, split into W1 and country/region variants.
src/GDL	Additional country/region-specific application content.
src/Tools	Developer tools — Test Framework, Performance Toolkit, AI Test Toolkit, Red Team Scan.
src/DemoTool	The tool that generates Business Central demonstration data.
src/DisabledTests	Test apps that are temporarily disabled.
src/rulesets	Code-analysis rulesets used when building the apps.
build	Build orchestration. build/projects defines the AL-Go projects and build/scripts the supporting automation; build.ps1 builds the repo locally.
tools	Repository-level agent tooling and developer plugins, including the Copilot PR review integration.
docs	Repository and feature documentation.

Contributing

We welcome contributions across the Business Central application platform — the System Application, Business Foundation, the Base Application, the first-party apps, and the developer tools.

Want to get involved? Start with our Contribution Guidelines. To build and validate your changes locally, see the Local Development Environment guidelines.

Every contribution needs an approved GitHub issue before a Pull Request is opened — this saves you from writing code that can't be accepted. The full process is described in CONTRIBUTING.md.

⚠IMPORTANT⚠: This is not the right place to report product defects with customer impact to Microsoft! Issues created in this repository might not get picked up by the Microsoft engineering team and do not fall under SLAs (Service Level Agreements); they have no guaranteed time to mitigation, and provided fixes won't get backported to all supported versions of the product. For customer-impacting defects, follow "Technical Support for Dynamics 365 Business Central".

Building Business Central with agents

Now that the collaboration platform is in place, we're reimagining how the application is built. AI agents are starting to assist at every stage of the engineering process — they assist developers, they don't replace them:

• Code Review agent — a "Copilot for PRs" already running in the BCApps CI pipeline. It inspects pull requests, posts review comments, and runs quality checks against shared best practices. See tools/Code Review.
• BCQuality — an open, agent-consumable knowledge base of Business Central best practices, patterns, and guidelines. It is layered (Microsoft / Community / Custom) so partners can extend and override the rules the agents follow. The BCApps Copilot reviewer consumes it through the integration under tools/Code Review.

The direction is for this agent framework to ship as part of AL-Go for GitHub, so every partner's pipeline can opt into agents — configured through BCQuality — without complex setup.

Business Central

Business Central is a business management solution for small and mid-sized organizations that automates and streamlines business processes and helps you manage your business. Highly adaptable and rich with features, Business Central enables companies to manage their business — including finance, manufacturing, sales, shipping, project management, services, and more. Companies can easily add functionality that is relevant to their region of operation and customized to support even highly specialized industries. Business Central is fast to implement, easy to configure, and simplicity guides innovations in product design, development, implementation, and usability.

Extensibility requests

All extensibility requests for Business Central apps are now handled in the BCApps repository.

The following are the types of requests you can submit to unblock your app:

• Add new integration events – Get the event you need to hook-in to a process.
• Change function visibility – For example, make a public function external or a similar change so you can call it from your extension and reuse the business logic.
• Replace Option with Enum – Replace a specific option with an enum that supports your extension. The new type enum is extensible, but all code was written for non-extensible options.
• Extensibility enhancements – Request changes in the application code that will improve extensibility.

Before creating a request, search existing issues to avoid duplicates and read the guidance for creating extensibility requests.

You may optionally provide an implementation pull request after the request is approved. We recommend this when you need multiple extensibility points (5+) related to the same functionality.

We’ll have a look at your request, and if we can we’ll implement it asap. If we can’t we’ll let you know and briefly explain why not. When that happens, don’t be discouraged. Go back to the drawing board, see if you can work it out, and then come back and submit another request.

More resources

• Getting help & support — see SUPPORT.md for where to ask questions and how issues are handled.
• Reporting security issues — please follow our Security Policy; do not open public issues for security vulnerabilities.
• This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected].
• New to contributing on GitHub? Follow the GitHub quickstart guidelines.
• New to developing for Business Central? Visit the Developers Learning Catalog.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos is subject to those third-parties' policies.