@quranjs/create-app

Scaffold Quran Foundation starter apps with one command.

Quick start

npx @quranjs/create-app@latest my-quran-app --template next --package-manager npm --install --git --sdk-source npm --yes

Use SvelteKit instead:

npx @quranjs/create-app@latest my-quran-app --template sveltekit --package-manager npm --install --git --sdk-source npm --yes

Templates

• next — Next.js App Router starter.
• sveltekit — SvelteKit starter.

Both templates keep Quran Foundation secrets server-side and use the runtime-split SDK boundary:

• @quranjs/api/public for browser-safe OAuth initiation.
• @quranjs/api/server for token exchange, refresh, and backend API calls.

Flags

• --template next|sveltekit
• --package-manager npm|pnpm|yarn|bun
• --install / --no-install
• --git / --no-git
• --yes
• --sdk-source npm|local
• --sdk-local-path <path>
• --app-base-url <url>

Required environment variables in generated apps

• APP_BASE_URL
• CLIENT_ID
• CLIENT_SECRET
• SESSION_SECRET

Keep CLIENT_SECRET and SESSION_SECRET out of browser code and public config.