Random Web Bits (private repository)

Project name: RWBDotnetTypeScript
Document date: 12/01/2025
Technologies: Dotnet, TypeScript

Start Without Debugging

To begin project development, first, check the prerequisites, then, second, follow the build procedure.

PREREQUISITES

Client (browser) files are compiled and are designed to welcome internet folks to freely navigate and/or interact with. The source code is not obfuscated and is also not optimized for performance. Instead, open-source-style development, here, allows website users to use the developer’s tools for exploring and interacting with the components’ source code.

Note: This procedure outline is for the developer and is used throughout the app’s development.

• Check the /wwwroot folder for scripts, CSS, and asset files per this list: i. /css ii. /library iii. /src iv. favicon.ico & robots.txt

Steps

1. Clean and build|rebuild the solution

2. Again, check the /wwwroot folder per the prerequisites

3. Fix any build errors before proceeding. On success, the project should have \bin\Debug\net9.0\RWBDotnetTypeScript.dll file created

4. [OPTIONAL] Reset the wwwroot/src folder compilation using the Task Runner Explorer feature i. Navigate to the project’s folder and run the below (4) dependency installations

   # They install gulp
   #
   #Node.JS commands to bring up the development
   npm install
   "npm run env:status"
   "npm run dev"
   "npm run dev:init"
   "npm run build:clientjs"
   
   

   1. Restart the IDE

   2. First, run gulp and scripts tasks

   3. Begin the debugging

   The below first line of code (gulpfile.js) should be verbatim to provide the gulp tasks’ operation.

   /// <binding AfterBuild='scripts' Clean='clean' />
   

---

Useful Commands

To clean or build the TypeScript files, run the following commands in the terminal:

npm cache verify
npx tsc --project src/tsconfig.json --listFiles
npx gulp clean
npx tsc --project src/tsconfig.json --noEmit --listFiles
npx tsc --project src/tsconfig.json

To clear the local NuGet package cache, run the following command in the terminal:

dotnet nuget locals global-packages --clear

ESBuild example create bundle (used previously in package.json): esbuild src/components/global/photoswipe.ts –bundle –format=esm –platform=browser –outfile=wwwroot/src/components/global/photoswipe.js –sourcemap