config.rk
Layer 4: defaults for an organisation (company). Organisations and members themselves are data in the database, managed in Console; this file seeds defaults and is what Rangka AI edits through change sets.
Lives in <site>/config.rk · Schema config.json (source) · first line: # yaml-language-server: $schema=https://rangka-os.github.io/rangka-os/schema/0.5/config.json
Properties
| Property | Type | Meaning |
|---|---|---|
locale | string | default "id-ID" |
currency | IDR | default "IDR" |
timezone | string | default "Asia/Jakarta" |
fiscal_year_start | string | default "01-01", pattern ^[0-1][0-9]-[0-3][0-9]$ |
tax | object | |
tax.ppn_rate | number | default 12, min 0, max 100 |
tax.dpp_ratio | string | default "11/12" |
tax.pkp | boolean | default false |
tax.ppn_fee_only | boolean | PPN on the service fee only: invoice lines marked as the workers' wages (ppn_exclude) stay out of the PPN base (DPP nilai lain, PMK 83/2012). Default false. default false |
numbering | map of string or object | A series (object) or a per-model naming override (string), e.g. sales_invoice: 'INV-{YYYY}-{#####}' |
plan | name | snake_case, never renamed once released pattern ^[a-z][a-z0-9_]{0,62}$ |
theme | name | snake_case, never renamed once released pattern ^[a-z][a-z0-9_]{0,62}$ |
layout | name | snake_case, never renamed once released pattern ^[a-z][a-z0-9_]{0,62}$ |
sso | object | |
sso.domains | list of string | |
sso.upstream | name | snake_case, never renamed once released pattern ^[a-z][a-z0-9_]{0,62}$ |
sso.required | boolean | default false |
ai | object | |
ai.enabled | boolean | default true |
ai.auto_apply | never · low_risk | low_risk lets Rangka AI apply layer-6 changes (theme, layout, labels) without approval default "never" |
ai.approvers | list of name | Roles that can approve change sets |
ai.proposers | list of name | Roles (besides the approvers) that can propose change sets from the web app's Ubah mode default [] |
onboarding | object | |
onboarding.process | string | The process Mulai di sini follows (contract 0053 §2) pattern ^[a-z][a-z0-9_]*$ |
apps | list of name | Installed apps, in menu order. Must be allowed by the plan. |
modules | map of string | module → version range (^1.0, >=1.2): modules installed on their own, next to apps (contract 0032). The validators add each module's requires; the plan must allow them. Not allowed under orgs.<id>.config. |
connectors | list of name | Connectors switched on before any flow uses them (contract 0036). Site-wide: not allowed under orgs.<id>.config. |
connector_auth | list of name | Roles (besides owner) that may set and remove connector secrets through the API (contract 0017 §3). Site-wide. |
org | object | The legal entity printed on documents |
org.legal_name | string | |
org.npwp | string | |
org.pkp | boolean | default false |
orgs | map of object | Per-org settings by org id; an org's config overrides this file's keys for that org (contract 0010) |
Example
From rangka-apps/examples/sites/kopi-senja/config.rk (first 60 lines):
yaml
# yaml-language-server: $schema=https://rangka-os.github.io/rangka-os/schema/0.5/config.json
locale: id-ID
currency: IDR
timezone: Asia/Jakarta
tax: {ppn_rate: 12, dpp_ratio: 11/12, pkp: true}
numbering:
invoice: {pattern: "INV-{YYYY}-{#####}", reset: yearly}
apps: [crm]
plan: tumbuh
theme: kopi_senja
layout: crm_first
sso: {domains: [kopisenja.test], required: false}
ai: {enabled: true, auto_apply: never, approvers: [owner, sales_manager]}Generated from the schema by website/scripts/gen-reference.mjs. Edit the schema, not this page.