This project uses Val Town Projects architecture for modular deployment.

1. Val Town CLI installed:

   npm install -g @valtown/cli

2. Authenticate with Val Town:

   vt auth

3. Environment Variables:

   • OPENAI_API_KEY - Your OpenAI API key
   • VAL_TOWN_API_KEY - Automatically provided by Val Town

Prompt_Improver/
├── index.http.ts           # Main HTTP handler
├── val.json               # Project configuration
├── workers/
│   ├── clarifier.ts       # Clarification worker
│   ├── condenser.ts       # Condensation worker
│   └── includer.ts        # Enhancement worker
├── frontend/
│   ├── index.html         # Frontend UI
│   └── ...
├── backend/
│   ├── backend_logic.js   # Orchestration logic
│   └── ...
├── shared/
│   └── shared_utils.js    # Shared utilities
└── README.md

From the project root directory:

cd /home/toowired/Prompt_Improver
vt push

This will:

• Deploy the entire project as a Val Town Project
• Create the main HTTP endpoint
• Bundle all workers, frontend, and backend code
• Set up proper routing and imports

vt status

vt logs

For local development:

vt dev

After deployment, your application will be available at:

https://[username]-prompt-improver.web.val.run

• GET / - Frontend interface
• POST /api/improve - Improve prompt endpoint
• GET /health - Health check
• GET /api/test-workers - Test all workers

The val.json file configures:

• Entry point: index.http.ts
• Project type: HTTP
• Dependencies: Hono, OpenAI, Val Town utils
• Environment variables required
• Public visibility

1. Single Deployment: One vt push deploys everything
2. Local Workers: All workers run in the same context (fast)
3. Relative Imports: Clean import paths within the project
4. File Serving: Frontend files served directly from project
5. Version Control: Entire project versioned together

vt auth --reset

Check that:

• You're in the correct directory
• val.json is valid JSON
• All imports use correct relative paths

vt logs --tail

Set in Val Town dashboard:

1. Go to your val's settings
2. Add OPENAI_API_KEY
3. VAL_TOWN_API_KEY is automatically provided

To update the deployed project:

vt push

This will update the existing deployment with your changes.

Before deployment, test locally:

vt dev

Visit http://localhost:3000 to test the application.

• Frontend files in /frontend/ are served via serveFile()
• Workers are imported directly as TypeScript modules
• Shared utilities available to all components
• Backend logic handles orchestration

This architecture provides the benefits of modular design while keeping everything in a single deployable project.