16 replies

Organising Convex files with folders

❔Advice

I'd like to organise my Convex functions by moving, for example,

convex/orders.ts

convex/orders.ts

convex/(orders)/orders.ts

convex/(orders)/orders.ts

. The parenthesised folder

(orders)

(orders)

is ignored by Convex's API generation (which is what I want), ensuring that

api.orders.getById

api.orders.getById

(used in my frontend, react-native app) remains unchanged and non-breaking.

Is this an officially supported file organisation pattern in Convex, and is there documentation for it?
I want to ensure this behaviour won't change in a future update, which could break my client's API.