chore: update readme

Author: oshankkkk

README.md

@@ -1,78 +1,58 @@
-# Cloud Markdown
+# Puffnotes
 
-A simple markdown notes app with:
+Puffnotes is a simple markdown notes app for writing, editing, and managing notes in one place.
 
-- React + Vite frontend
-- Go backend
-- PostgreSQL for storage
-- Clerk for authentication
+The app is hosted on Railway: https://puffnotes.up.railway.app
 
-## Project Structure
+## Tech Stack
 
-- `frontend/` - React app
-- `backend/` - Go API
+- React 19
+- TypeScript
+- Vite
+- Tailwind CSS
+- TipTap editor
+- Clerk authentication
+- Go
+- PostgreSQL
+- Railway
 
-## Environment
+## Running Locally
 
-Copy `.env.example` to `.env` and fill in the Clerk values:
+### 1. Add your environment variables
+
+Copy `.env.example` to `.env` and update the values.
 
 ```env
 CLERK_SECRET_KEY=
 VITE_CLERK_PUBLISHABLE_KEY=
-VITE_API_BASE_URL=
+VITE_API_BASE_URL=http://localhost:8080
+DB_URL=postgres://postgres:postgres@localhost:5432/puffnotes
+HTTP_PORT=:8080
 ```
 
-Notes:
-
-- The frontend uses Clerk in the browser.
-- The backend reads `CLERK_SECRET_KEY` from the repo root `.env`.
-- The backend database URL is currently hardcoded in `backend/cmd/main.go`.
-
-## Run the Frontend
+### 2. Start the frontend
 
 ```bash
 cd frontend
 npm install
 npm run dev
 ```
 
-Default dev URL:
+The frontend runs on `http://localhost:5173`.
 
-```text
-http://localhost:5173
-```
+### 3. Start the backend
 
-## Run the Backend
-
-Make sure PostgreSQL is running and the `puffnotes` database exists.
-
-Current hardcoded database connection:
-
-```text
-postgres://oshan:123@localhost:5432/puffnotes
-```
-
-Then start the API:
+Make sure PostgreSQL is running first, then run:
 
 ```bash
 cd backend
-go run ./cmd
-```
-
-Default API URL:
-
-```text
-http://localhost:8080
+go run ./cmd/server
 ```
 
-## Auth Flow
-
-- Clerk handles sign-in in the frontend.
-- The frontend sends the Clerk token in the `Authorization` header.
-- The Go backend verifies the token with Clerk middleware before serving `/notes` routes.
+The API runs on `http://localhost:8080`.
 
-## Current Status
+## Notes
 
-- Auth is wired for signed-in access.
+- Clerk is used for authentication.
 - Notes are stored in PostgreSQL.
-- The app is still early-stage and some API behavior is still being cleaned up.
+- The frontend talks to the Go API using `VITE_API_BASE_URL`.