Skip to content

docs: Cursor Cloud development environment setup#8

Closed
captenmasin wants to merge 1 commit into
masterfrom
cursor/dev-environment-setup-e7f6
Closed

docs: Cursor Cloud development environment setup#8
captenmasin wants to merge 1 commit into
masterfrom
cursor/dev-environment-setup-e7f6

Conversation

@captenmasin

Copy link
Copy Markdown
Owner

Summary

Adds ## Cursor Cloud specific instructions to AGENTS.md so future Cloud Agents can set up and run BookBound without Laravel Herd.

Covers:

  • One-time PHP 8.4 / Node system dependencies
  • First-time app setup (.env, SQLite, migrate, seed, build)
  • Recommended .env overrides for VMs without Redis/Meilisearch
  • How to start Laravel + Vite dev servers
  • Lint/test/build commands and common gotchas

VM update script

composer install --no-interaction --prefer-dist
npm ci

Verification performed

  • Installed PHP 8.4.22, Composer, composer install, npm ci
  • Configured .env with sync queue + database scout + Google Books API
  • Ran migrations + db:seed, npm run build
  • Started php artisan serve and npm run dev
  • 34 feature tests passed (Home, Registration, AddBookToUser)
  • Browser demo: registered user → logged in → library with book → book detail page

BookBound library with Dune

bookbound-dev-environment-demo.mp4

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

Document PHP/Node setup, recommended .env overrides for Cloud Agent VMs,
service startup commands, and common gotchas for BookBound local development.

Co-authored-by: Mason Day <captenmasin@users.noreply.github.com>
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