asp-classic-unified-framework/docs/development-instructions.md

Development Instructions

Date: 2026-03-11T11:59:39Z

Prerequisites

• Windows Server or Windows development environment
• IIS with Classic ASP enabled
• IIS URL Rewrite module
• Microsoft Access Database Engine for .accdb support
• Windows Script Host / cscript

Setup

1. Copy the project to the target IIS host.
2. Point the IIS site root to public/.
3. Update public/web.config:
   • ConnectionString
   • ErrorLogPath if logging is desired
4. Ensure the Access database file path is valid for the environment.

Common Development Tasks

Generate a migration

cscript //nologo scripts\generateMigration.vbs create_my_table

Generate POBO and repository

cscript //nologo scripts\GenerateRepo.vbs /table:my_table /pk:id

Move generated files into app/models/ and app/repositories/.

Generate a controller

cscript //nologo scripts\generateController.vbs MyController "Index;Show(id);Create;Store"

Move the generated controller into app/controllers/.

Activate a controller

After generating a controller:

1. Include it from app/controllers/autoload_controllers.asp
2. Register it in core/lib.ControllerRegistry.asp
3. Add routes in public/Default.asp
4. Create corresponding views in app/views/

Validation Approach

• Manual browser validation is required for runtime changes.
• Route/layout changes should be checked through IIS-hosted execution.
• Migration and generator changes should be validated with cscript.