DocumentationMethacore Apps

Troubleshooting & FAQ

7 min read · last updated 23 September 2026

The most common pitfalls, sorted by where they occur.

Studio

The Studio does not show my app

The Studio lists projects that have "Methacore Apps" enabled and belong to a team in which your linked Artim Developer Portal account is a member. Check in the Artim Developer Portal whether the API is active and whether you are in the right team. If you linked a different Artim Developer Portal account from the one you work with in the Artim Developer Portal, you see that account's apps.

"No OAuth client yet" in the settings

The project does not have a client for the "Methacore Apps" API yet. Create one in the Artim Developer Portal under OAuth; it will then be available for selection in the settings.

My draft is not saved

The Studio does not save an invalid app.json. The error message is then shown at the top – often a duplicate id, a tab without a label or a typo in the JSON. In addition, the draft may be at most 512 KB.

"Fix the errors in app.json first" when publishing

See above: a version can only be created from a valid draft.

"The version must be higher than the last one"

Versions follow semver and always increase. After 1.2.0 comes 1.2.1, 1.3.0 or 2.0.0 – even if 1.2.0 was rejected.

Preview

"auth.clientId is missing in app.json"

Select an OAuth client under Settings. Without a client, the app cannot load any data.

"Sign-in window blocked"

The consent page opens as a pop-up. Allow pop-ups for studio.methacore.de and click again.

The preview shows no data, but the builder does

The builder shows sample data, the preview your real data. If you have no events in the selected club, the table stays empty. Also check whether the source's scope is listed in auth.scopes.

Runtime

"Action failed: This token does not carry the … scope."

The scope is missing from the token and the member declined "Extend access" – or the scope is already missing on the OAuth client. Add it to the client and to auth.scopes.

"Action failed: Handler "x" is not exported by main.js."

The function is not exported or has a different name. Handlers need export: export async function x(ctx) { … }. Also check the console – a syntax error in main.js prevents all handlers from loading.

"The data for the export is not a list."

The data of the export action must stand alone and point to a list: "{{state.termine}}", not "Termine: {{state.termine}}". For sources with pick, check that the state holds the list and not the whole object { items: … }.

An expression stays empty

Expressions are plain paths. {{state.termine.length}} works, {{state.termine.length > 0}} does not. Paths are case-sensitive, and values from bindings are only in the state once the source has responded – while loading, {{state.$loading.<key>}} is true.

413 App storage quota exceeded.

The app has used 10 MB in this club. Delete old entries or store less per entry. The quota applies per club – the app is not affected in other clubs.

My web font / external stylesheet does not load

The security policy of hosted apps allows no web fonts and no @import from external addresses. Use system fonts via --mc-font-family. Images via https: work. Details under Styling.

My colours disappear in the dark theme

In the dark theme, the runtime sets its own colours under :root[data-mc-theme="dark"]. Override them there as well – see Light and dark theme.

fetch to my server fails

Hosted apps can only reach *.api.methacore.de and the Artim Developer Portal. If you need your own server, an external app is the right way.

Store and approval

My app is in the store but cannot be opened

A hosted app needs an approved version – even in your own club. While the first version is in review, use the preview in the Studio.

Other clubs do not see my app

Three things must be true: the "Public" switch is on, the app is approved, and the club's policy allows it. In addition, it only appears on the platform of its target.

"Public" cannot be saved

Required fields for a public listing are missing: name, both descriptions, category, icon and at least one screenshot, and for external apps the address. The message ("A public app is still missing: …") lists what is missing.

How long does the review take?

That depends on the scope of the app. The decision appears in the Studio and in the Artim Developer Portal within a minute of being made.

Why does my hosted app have no seal?

The seal is granted as soon as the live version is approved. As long as no version has been approved, the store shows "Not yet reviewed".

External apps

The app stays white in the dashboard

Usually your page forbids embedding (X-Frame-Options or frame-ancestors). Allow https://admin.methacore.de. Also check the browser console for CSP errors from your own page.

"The app's address is outside your project's authorised domains."

Add the domain to the authorised domains of your project in the Artim Developer Portal and verify it, then save the listing again.

The store shows my app as unreachable

The daily check did not receive a valid https response. The notice disappears after the next successful check.

Standalone: "The login response does not match the started login."

The state of the return does not match the started sign-in – usually because the sign-in began in a different tab or on a different domain (with/without www). Start and finish the sign-in at the same address.

Further help

If you cannot find anything here, contact us via support in the Artim Developer Portal. Include the app ID (prj_…), the version and – for API errors – the request_id from the error response.