@pageai/ralph-loop 1.4.0 → 1.5.0

package/.agent/STEERING.md

@@ -2,4 +2,5 @@
 
 Go to the source code directory and install dependencies.
 
-Check that Playwright is running by starting the dev server and taking a screenshot. Save the screenshot to the .agent/screenshots directory.
+Check that Playwright is installed, then start the dev server and take a screenshot.
+Save the screenshot to the .agent/screenshots directory.

package/README.md

@@ -41,12 +41,10 @@ This is an implementation that actually works, containing a hackable script so y
 I recommend using a CLI to bootstrap your project with the necessary tools and dependencies, e.g.:
 
 ```bash
-npx create-vite@latest src --template react-ts
-# or
-npx create-next-app@latest src
+npx @tanstack/cli create lib --add-ons shadcn,eslint,form,tanstack-query
 ```
 
-> If you must start from a blank slate, which is not recommended, see [Starting from scratch](#starting-from-scratch).
+> If you must start from a blank slate, which is not recommended, see [Starting from scratch](#starting-from-scratch). You can also go for a more barebone start by running `npx create-vite@latest src --template react-ts`
 
 ### 1️⃣ Step 1: Install Ralph
 
@@ -64,7 +62,7 @@ Open up Claude Code and prompt it with **your requirements**. Like so:
 ```
 Use the prd-creator skill to help me create a PRD and task list for the below requirements.
 
-An app is already set up with Next.js, Tailwind CSS and TypeScript.
+An app is already set up with React, Tailwind CSS and TypeScript.
 
 Requirements:
 
@@ -353,14 +351,14 @@ import '@testing-library/jest-dom/vitest'
 import { vi } from 'vitest'
 import React from 'react'
 
-// Mock next/image
+// If using Next.js, mock next/image
 vi.mock('next/image', () => ({
   default: ({ src, alt, ...props }: { src: string; alt: string }) => {
     return React.createElement('img', { src, alt, ...props })
   },
 }))
 
-// Mock next/link
+// If using Next.js, mock next/link
 vi.mock('next/link', () => ({
   default: ({
     children,
@@ -395,7 +393,7 @@ See more in [Docker's docs](https://docs.docker.com/ai/sandboxes/migration/).
 
 For AI to actually verify its implementation and for the loop to work, you need a way to verify it.
 
-To that end, at the minimum you need an end-to-end test framework and a unit test framework.
+To that end, at the minimum you'll need an end-to-end test framework and a unit test framework.
 
 For example, you can use the following commands to install Playwright and Vitest:
 

package/bin/cli.js

@@ -14,7 +14,7 @@ const { copyFile, copyDir, mergeDir, exists, ensureDir } = require('./lib/copy')
 
 const PACKAGE_ROOT = path.resolve(__dirname, '..');
 const TARGET_DIR = process.cwd();
-const DEFAULT_APP_DIR = 'src';
+const DEFAULT_APP_DIR = 'lib';
 
 // Directories to ensure exist (created even if source doesn't exist)
 const DIRS_TO_ENSURE = [
@@ -104,7 +104,7 @@ async function main() {
 
   // Prompt 1 — App source directory
   const appDir = await clack.text({
-    message: 'Where does your app source code live? (e.g. src, public, etc.)',
+    message: 'Where does your app source code live? (e.g. lib, app, src, public, etc.)',
     placeholder: DEFAULT_APP_DIR,
     defaultValue: DEFAULT_APP_DIR,
   });

package/bin/lib/display.js

@@ -96,7 +96,7 @@ ${G}  ✓ Ralph Loop setup complete!${R}
 ${D}═══════════════════════════════════════════════════════════${R}
 
 ${Y}Next steps:${R}
-  ${C}1.${R} Review the copied files
+  ${C}1.${R} Log in to your CLI agent with ${G}docker sandbox run claude .${R}
   ${C}2.${R} Create a PRD using the ${G}prd-creator${R} skill
   ${C}3.${R} Run ${G}./ralph.sh${R} to start the loop
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pageai/ralph-loop",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "publishConfig": {
     "access": "public"
   },