Skip to content

docs(local-setup): add backend, admin app, and client SDK dev guide - #1814

Open
Shreyag02 wants to merge 1 commit into
mainfrom
docs/iam-frontend-client-sdk-local-setup
Open

docs(local-setup): add backend, admin app, and client SDK dev guide#1814
Shreyag02 wants to merge 1 commit into
mainfrom
docs/iam-frontend-client-sdk-local-setup

Conversation

@Shreyag02

Copy link
Copy Markdown
Contributor

Document local dev setup for the IAM Admin console frontend: running the backend and deps, the admin app, and the client SDK demo.

@vercel

vercel Bot commented Jul 28, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
frontier Error Error Jul 28, 2026 3:13pm

@coderabbitai

coderabbitai Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive macOS local development guide for running Frontier’s backend, frontend, and client SDK with Docker.
    • Documented setup prerequisites, environment configuration, local and remote backend switching, database migration, and SDK development workflows.
    • Added troubleshooting guidance for common setup issues, plus reference tables for environment variables, ports, and key configuration values.

Walkthrough

Changes

Local setup guide

Layer / File(s) Summary
Backend setup workflow
docs/content/docs/local-setup.mdx
Documents Docker dependency startup, database migration, backend launch, and health checks.
Frontend and SDK workflows
docs/content/docs/local-setup.mdx
Documents admin frontend configuration, remote/local endpoint switching, client-demo modes, SDK builds, and proxy behavior.
Troubleshooting and configuration reference
docs/content/docs/local-setup.mdx
Adds common gotchas and references for environment variables, ports, CORS, database, and SpiceDB settings.

Estimated code review effort: 2 (Simple) | ~10 minutes

🚥 Pre-merge checks | ✅ 2
✅ Passed checks (2 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

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

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 92712be4-c807-4c90-b859-34928513334a

📥 Commits

Reviewing files that changed from the base of the PR and between ab8b990 and fce62d3.

📒 Files selected for processing (1)
  • docs/content/docs/local-setup.mdx

Comment on lines +47 to +49
- `docker ps` — `frontier-pg-1`, `frontier-pg2-1`, `frontier-spicedb-1` all `(healthy)`.
- `lsof -nP -iTCP:8002 -sTCP:LISTEN` — backend listening.
- `docker exec frontier-pg-1 psql -U frontier -d frontier -c '\dt' | head` — app tables exist.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Avoid hard-coded Compose container names.

The guide permits a different clone location, but frontier-pg-1 is derived from the Compose project name and can differ by checkout directory or Compose version. Query services through the same Compose project instead.

Proposed fix
- `docker ps` — `frontier-pg-1`, `frontier-pg2-1`, `frontier-spicedb-1` all `(healthy)`.
+ `cd frontier && docker-compose -f docker-compose.yml ps` — `pg`, `pg2`, and `spicedb` should be healthy.
  - `lsof -nP -iTCP:8002 -sTCP:LISTEN` — backend listening.
- `docker exec frontier-pg-1 psql -U frontier -d frontier -c '\dt' | head` — app tables exist.
+ `cd frontier && docker-compose -f docker-compose.yml exec -T pg psql -U frontier -d frontier -c '\dt' | head` — app tables exist.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant