Skip to content

docs: add Cursor Cloud dev environment setup notes - #25

Draft
ephraimduncan wants to merge 1 commit into
mainfrom
cursor/setup-dev-environment-5f2d
Draft

docs: add Cursor Cloud dev environment setup notes#25
ephraimduncan wants to merge 1 commit into
mainfrom
cursor/setup-dev-environment-5f2d

Conversation

@ephraimduncan

Copy link
Copy Markdown
Owner

Summary

Sets up and documents the development environment for the Weekday Calendar monorepo (Bun + Turborepo + Next.js 16 + PostgreSQL + Drizzle + Better Auth).

Adds an AGENTS.md with a ## Cursor Cloud specific instructions section capturing the non-obvious caveats for running this project:

  • PostgreSQL must run on port 5433 (Docker unavailable here; Postgres installed as a system cluster).
  • .env is required and gitignored; which vars are needed and which can be placeholders.
  • Login is Google-only — real login needs Google OAuth credentials; app otherwise boots fully.
  • Root turbo lint has no lint task; ESLint on this commit throws a circular-JSON error (eslint-config-next@16 + FlatCompat incompatibility, pre-existing).
  • No automated test scripts exist.

The suggested startup update script is minimal: bun install.

Verification

Environment was set up and the app run end-to-end in development mode.

weekday_app_walkthrough.mp4

Landing page, login page, and protected-route redirect all working:

Landing page
Login page
/calendar redirects to /login

The Google OAuth sign-in action was exercised via the auth API, generating a real Google authorization URL and persisting the corresponding state to Postgres — proving the app → auth → DB pipeline works.

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

Co-authored-by: Ephraim Duncan <ephraimduncan@users.noreply.github.com>
Comment thread AGENTS.md
@@ -0,0 +1,59 @@
# AGENTS.md

## Cursor Cloud specific instructions

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

cursor specific?

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.

2 participants