WT/STEP_BY_STEP.txt at main · ampedprojects5-coder/WT · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
╔══════════════════════════════════════════════════════════════╗
║         STEP-BY-STEP: GET IT WORKING                        ║
╚══════════════════════════════════════════════════════════════╝

Follow these steps EXACTLY in order:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

STEP 1: Run Diagnostic
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   Double-click: DIAGNOSE.bat

   This will tell you EXACTLY what's wrong.

   Read the output carefully - it will tell you what to do next.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

STEP 2: If Diagnostic Says Node.js is Missing
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   A. Go to: https://nodejs.org/

   B. You'll see TWO download buttons:
      - LTS (recommended) ← CLICK THIS ONE
      - Current (latest)

   C. Download the file (it's about 30MB)

   D. Double-click the downloaded file

   E. Click "Next" on every screen (use defaults)

   F. When it says "Finish", click it

   G. RESTART YOUR COMPUTER (very important!)

   H. After restart, run DIAGNOSE.bat again

   I. If it now says [OK], go to STEP 3

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

STEP 3: Open Terminal (Choose ONE method)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   METHOD A: VS Code (if you have it)
   -----------------------------------
   1. Open VS Code
   2. File → Open Folder
   3. Select this Application folder
   4. Press Ctrl + ` (backtick key, above Tab)
   5. A terminal appears at the bottom
   6. Go to STEP 4

   METHOD B: Right-Click Menu
   ---------------------------
   1. Right-click on empty space in this folder
   2. Look for "Open in Terminal" or "Open in Windows Terminal"
   3. Click it
   4. A terminal window opens
   5. Go to STEP 4

   METHOD C: Command Prompt
   ------------------------
   1. Press Windows Key + R
   2. Type: cmd
   3. Press Enter
   4. Type: cd /d "C:\Users\trmab\OneDrive\Documents\work\Application"
   5. Press Enter
   6. Go to STEP 4

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

STEP 4: Install Dependencies (First Time Only)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   In the terminal, type exactly:

   npm install

   Press Enter.

   Wait for it to finish (takes 1-2 minutes).

   You'll see lots of text scrolling.

   When it stops and shows a prompt again, it's done.

   If you see errors, write them down and see TROUBLESHOOTING.txt

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

STEP 5: Start the App
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   In the same terminal, type:

   npm run dev

   Press Enter.

   You should see:
   ✓ VITE v5.x.x  ready in xxx ms
   ✓ Local:   http://localhost:3000/

   Your browser should open automatically.

   If not, open your browser and go to: http://localhost:3000

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

STEP 6: Keep Terminal Open
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   DON'T CLOSE the terminal window!

   The app needs it to run.

   To stop the app: Press Ctrl+C in the terminal

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

❓ WHAT IF IT STILL DOESN'T WORK?
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   1. Run DIAGNOSE.bat again
   2. Read the error messages carefully
   3. Check TROUBLESHOOTING.txt
   4. Make sure you:
      ✓ Installed Node.js from nodejs.org
      ✓ Restarted your computer after installing
      ✓ Are in the correct folder (Application folder)
      ✓ Typed commands exactly as shown

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

💡 REMEMBER:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   • First time: npm install (takes 1-2 minutes)
   • Every time: npm run dev (starts instantly)
   • Keep terminal open while app is running
   • Browser should open automatically

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━