Use ArkEnv

[yamcodes]

Description

Use ArkEnv for environment variables. Related to #213

---

PR Checklist

• Read the Developer's Guide in CONTRIBUTING.md
• Use a concise title to represent the changes introduced in this PR
• Provide a detailed description of the changes introduced in this PR, and, if necessary, some screenshots
• Reference an issue or discussion where the feature or changes have been previously discussed
• Add a failing test that passes with the changes introduced in this PR, or explain why it's not feasible
• Add documentation for the feature or changes introduced in this PR to the docs; you can run them with bun docs

Summary by CodeRabbit

• Refactor

  • Switched the app’s environment configuration system to a new provider; imports and internal configs updated.
  • Server now reads its listen port from the environment (PORT) instead of a hardcoded value.

• Documentation

  • Added architecture and quickstart docs describing the new environment tooling and startup validation.
  • Updated example env to use PORT (renamed from APP_PORT).

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
bedstack	Ready	Preview, Comment	Jan 21, 2026 5:28pm

[coderabbitai]

Walkthrough

Migrates the Conduit app from an Elysia-based env system to ArkEnv: replaces defineEnv with arkenv, updates imports to an @env alias, removes legacy core env utilities/re-exports, updates package dependency, and adjusts example and startup port usage. Documentation is added for the new configuration approach.

Changes

Cohort / File(s)	Summary
Env config rewrite apps/conduit/env.config.ts	Replaced defineEnv(...) (Elysia schema) with arkenv(...) and redefined all env keys using ArkEnv schema/literals. Export shape changed to the arkenv call.
Dependency change apps/conduit/package.json	Removed @yolk-oss/elysia-env; added arkenv@^0.9.0.
Import updates apps/conduit/drizzle.config.ts, apps/conduit/drizzle/seed.ts, apps/conduit/src/auth/auth.service.ts, apps/conduit/src/main.ts	Switched environment imports from named @/core/env to default @env; main.ts now uses env.PORT instead of hardcoded port.
Core env module removal apps/conduit/src/core/env/define-env.util.ts, apps/conduit/src/core/env/env.ts, apps/conduit/src/core/env/index.ts	Deleted defineEnv utility and removed the intermediate env re-exports; env access consolidated to @env.
Docs and examples apps/www/content/docs/(architecture)/configuration.mdx, apps/www/content/docs/(architecture)/index.mdx, apps/www/content/docs/(architecture)/meta.json, apps/www/content/docs/(architecture)/what-is-bedstack.mdx, apps/www/content/docs/realworld/quickstart.mdx, .env.example	Added ArkEnv documentation and references, updated tech stack/docs to mention ArkEnv, and renamed APP_PORT→PORT in .env.example.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Poem

🐰 I hopped from old Elysia ground,

to ArkEnv fields where types abound.
Imports shifted, docs unfurled —
a tidy burrow for the config world. 🥕

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'Use ArkEnv' is concise and directly reflects the main change of the pull request: migrating environment variable handling from @yolk-oss/elysia-env to ArkEnv across the codebase.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[yamcodes]

@coderabbitai review

[coderabbitai]

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@apps/conduit/env.config.ts`:
- Around line 3-13: The current arkenv schema in env.config.ts defines
JWT_SECRET without a default, causing eager validation failures; remove
JWT_SECRET from this shared arkenv schema and create a separate auth-only env
module (e.g., auth.env.ts) that calls arkenv with JWT_SECRET as a required value
(no default), then update the authentication service to import JWT_SECRET from
the new auth.env.ts while leaving database/tooling code to import the original
env.config.ts (which may keep safe defaults for other vars); this decouples
tooling from app-only secrets (reference: arkenv export default, JWT_SECRET,
env.config.ts, and the new auth.env.ts module).

[coderabbitai]

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)

apps/conduit/.env.example (1)

1-8: Consider reordering keys to satisfy dotenv-linter.

This is a minor lint warning, but reordering avoids CI noise and keeps env files consistent.

♻️ Proposed ordering tweak

 POSTGRES_USER=postgres
 POSTGRES_PASSWORD=postgres
+PORT=3000
 POSTGRES_DB=medium
 POSTGRES_HOST=0.0.0.0
 POSTGRES_PORT=5432
 JWT_SECRET=supersecretkey
 JWT_ALGORITHM=HS256
-PORT=3000