Working on your project

Working with JetBrains

Using IntelliJ IDEA & co. with platform projects – what works out of the box and where you configure things yourself.

On this page

You can work on platform projects with JetBrains IDEs like IntelliJ IDEA without any issues – the code is plain Git repository material. The platform integration is intentionally leaner here than for VS Code, Cursor & Antigravity.

What the platform provides

  • The setup app can install IntelliJ IDEA and open projects directly in it.
  • The project folder contains an .idea directory (symlinked from local-configuration) as a shared place for team settings.

What you do yourself

  • Project configuration: run configurations, SDK assignment, and module setup are created in the IDE itself – the platform does not (yet) generate these.
  • Starting applications: use the IDE terminal with the ap CLI:
ap run-local
  • AI instructions: the generated agent rules (AGENTS.md, .cursor/rules) target the AI editors. If you use the JetBrains AI Assistant, point it manually at the AGENTS.md in the project root – see Telling the AI how to work.
Note
Tip: open the parent project folder with all repositories in JetBrains – that way you have backend, app, and configuration in one window.