My First Deployment Challenge (Without Knowing How to Code)

Sun, 09 Nov 2025 11:10:37 GMT

[Neural Visuals - Binaural Beats Visualization](https://neural-visuals-v2.vercel.app/) 오늘 드디어 내 프로젝트가 인터넷에 떴다. [https://neural-visuals-v2.vercel.app](https://neural-visuals-v2.vercel.app)이 주소를 처음 열었을 때 가슴이 두근거렸다. 내가 만든 게 정말로... 전 세계 누구나 볼 수 있게 된 거잖아. 솔직히 코딩은 하나도 모른다. TypeScript가 뭔지, Uint8Array가 뭔지도 몰랐다. 근데 어쩌다 보니 할머니를 위한 음악 시각화 프로젝트를 만들게 됐고, 이걸 배포해야 한다는 미션을 받았다. 처음엔 그냥 GitHub에 올리면 되는 줄 알았다. 근데 Vercel이라는 데서 계속 에러가 났다. 빨간 글씨가 화면을 가득 채웠다. error TS2345: Argument of type 'Uint8Array ' is not assignable... 뭔 소린지 하나도 모르겠어서 Claude한테 물어봤다. "이거 어떻게 고쳐요?" 했더니 파일을 수정해줬다. as Uint8Array라고 쓰면 된다고. 기대에 부풀어 Git 명령어를 쳤다. git add . git commit -m "fix: TypeScript errors" git push 근데 또 실패. 이번엔 브랜치가 엇갈렸다고 한다. 뭐가 엇갈린 건지 모르겠지만, 일단 git pull --rebase 해봤다. 근데 또 안 된다. Dropbox가 파일을 잠가서 Git이 못 쓴단다. 기다렸다가 다시 시도. 이번엔 git push --force-with-lease라는 신기한 명령어를 배웠다. 12.59MB 짜리 MP3 파일들이 쭈욱 올라갔다. "됐다!" 싶었는데... Vercel이 또 빌드 실패. 똑같은 에러. 아까 고친 게 소용없었나 보다. Claude가 다시 설명해줬다. as Uint8Array로는 부족하고, as Uint8Array 라고 더 정확하게 써야 한단다. 뭔 차이인지 모르겠지만 일단 따라했다. 세 번째 시도. git add . git commit -m "fix: Use more specific type assertion" git push 이번엔... 제발... 부디... Vercel 빌드 로그를 새로고침하면서 손톱을 물어뜯었다. 초록불이 하나씩 켜졌다. ✅ Building... ✅ Compiled successfully ✅ Deployed 됐다!!! 주소를 눌렀다. 검은 화면에 3D 파티클들이 음악에 맞춰 춤을 췄다. 내가 업로드한 바이노럴 비트 음악이 흘러나왔다. 컨트롤 패널에서 테마를 바꾸니까 Ocean Waves가 Midnight Ocean 색깔로 출렁였다. 나는 코딩을 모른다. Uint8Array 가 정확히 뭔지도 모른다. Git 명령어도 외운 게 아니라 그냥 Claude가 알려준 대로 친 거다. 근데 됐다. 세 번 실패하고 네 번째에 성공했다. 에러 메시지를 읽고, 물어보고, 시도하고, 또 실패하고, 다시 시도했다. 그랬더니 어느새 내 프로젝트가 세상에 나왔다. 지금 할머니한테 이 링크를 보냈다. "할머니, 이거 제가 만든 건데요. 밤에 이거 들으시면 잠 잘 오실 거예요." 할머니가 뭐라고 답장하실지 기대된다. 그리고... 나도 뿌듯하다. 코딩을 몰라도, 포기하지 않으면 뭐든 할 수 있다는 걸 오늘 배웠다. 2025년 11월 9일 고등학생 개발자(?)의 일기 --- Today, my project finally went live on the internet. [https://neural-visuals-v2.vercel.app](https://neural-visuals-v2.vercel.app)When I first opened this URL, my heart was pounding. Something I made... is now accessible to anyone in the world. Honestly, I don't know anything about coding. I had no idea what TypeScript was, or what Uint8Array meant. But somehow I ended up creating a music visualization project for my grandmother, and I received a mission to deploy it. At first, I thought I could just upload it to GitHub and be done. But Vercel kept throwing errors. Red text filled the screen. error TS2345: Argument of type 'Uint8Array ' is not assignable... I had no clue what it meant, so I asked Claude. "How do I fix this?" They modified the file for me. Said I needed to write as Uint8Array. Filled with hope, I typed the Git commands. git add . git commit -m "fix: TypeScript errors" git push But it failed again. This time, something about diverged branches. I didn't know what was diverging, but I tried git pull --rebase. Still didn't work. Apparently Dropbox was locking the files so Git couldn't use them. I waited and tried again. This time I learned a weird command called git push --force-with-lease. 12.59MB worth of MP3 files streamed up. "Got it!" I thought... Vercel build failed. Same error. I guess the fix didn't work. Claude explained again. as Uint8Array wasn't enough - I needed to write it more precisely as as Uint8Array . I didn't understand the difference, but I followed along. Third attempt. git add . git commit -m "fix: Use more specific type assertion" git push This time... please... I beg you... I refreshed the Vercel build log while biting my nails. Green lights started appearing one by one. ✅ Building... ✅ Compiled successfully ✅ Deployed It worked!!! I clicked the URL. On a black screen, 3D particles danced to the music. The binaural beat music I uploaded was playing. When I changed the theme in the control panel, Ocean Waves rippled in Midnight Ocean colors. I don't know how to code. I still don't know exactly what Uint8Array is. I didn't memorize the Git commands - I just typed what Claude told me to. But it worked. I failed three times and succeeded on the fourth try. I read error messages, asked questions, tried things, failed again, and tried again. Before I knew it, my project was out in the world. I just sent this link to my grandmother. "Grandma, I made this. If you listen to it at night, it'll help you sleep." I'm excited to see what she'll reply. And... I'm proud. Today I learned that even if you don't know how to code, you can do anything if you don't give up.