How bikramdhami0100/localshare works
LocalShare is a no-account shared content space for devices on the same LAN. A visitor opens the shared-space page, which loads content and folders, lets them create or edit notes, links, folders, and files, and reflects persisted changes to connected devices in real time. API routes validate requests and delegate persistence to the PostgreSQL-backed store; uploads additionally stream bytes to host storage. The README documents persistence, optimistic concurrency, and live updates; unsampled route and UI behavior is represented only where documented or indexed.
Main entry points: useSharedSpace.ts Shared-space state · page.tsx Shared-space page · store.mjs Shared data store · route.ts Content and folders API
Components 28
Shared-space client
- Shared-space page
app/page.tsx - Device identity
hooks/useDevice.ts - Shared-space state
hooks/useSharedSpace.ts - Content composer
components/Compose.tsx - Add content modal
components/AddContentModal.tsx - Edit content modal
components/EditContentModal.tsx - Content cards
components/ContentCard.tsx - Space header
components/Header.tsx - Change notices
components/NoticeStack.tsx - UI primitives
components/ui/Button.tsx
API and validation
- Content and folders API
app/api/content/route.ts - Content item API
app/api/content/[id]/route.ts - Folder API
app/api/folders/route.ts - Folder item API
app/api/folders/[id]/route.ts - Device API
app/api/device/route.ts - File upload API
app/api/files/upload/route.ts - File serving API
app/api/files/[id]/route.ts - Input validation
lib/validation.ts - API responses
lib/api.ts
Live updates
- Broadcast bridge
lib/broadcast.ts - WebSocket event hub
server/websocket/hub.mjs - Custom server
server.mjs
Persistence and files
- Shared data store
server/store.mjs - PostgreSQL pool
server/pool.mjs - File storage
server/storage/files.ts
Other components
- LAN visitors
- PostgreSQL
- Host filesystem
Connections 42
- LAN visitors → Shared-space page: opens
README.md - Shared-space page → Device identity: gets identity
app/page.tsx - Shared-space page → Shared-space state: loads shared state
app/page.tsx - Shared-space page → Content composer: renders editor
app/page.tsx - Shared-space page → Add content modal: renders creation
app/page.tsx - Shared-space page → Content cards: renders items
app/page.tsx - Shared-space page → Space header: renders header
app/page.tsx - Shared-space page → Change notices: renders notices
app/page.tsx - Content composer → Shared-space state: uses state
components/Compose.tsx - Add content modal → UI primitives: uses controls
components/AddContentModal.tsx - Edit content modal → UI primitives: uses controls
components/EditContentModal.tsx - Shared-space state → Content and folders API: fetches content
hooks/useSharedSpace.ts - Shared-space state → Folder API: fetches folders
hooks/useSharedSpace.ts - Shared-space state → Device API: checks health
hooks/useSharedSpace.ts - Shared-space state → Content item API: updates content
hooks/useSharedSpace.ts - Shared-space state → Folder item API: deletes folders
hooks/useSharedSpace.ts - Shared-space state → File upload API: uploads files
hooks/useSharedSpace.ts - Shared-space state → File serving API: builds download URL
hooks/useSharedSpace.ts - Shared-space state → WebSocket event hub: connects by WebSocket
README.md - Content and folders API → Input validation: validates writes
app/api/content/route.ts - Content and folders API → Shared data store: reads and creates
app/api/content/route.ts - Content and folders API → Broadcast bridge: announces creation
app/api/content/route.ts - Content item API → Shared data store: changes content
app/api/content/[id]/route.ts - Content item API → Broadcast bridge: announces changes
app/api/content/[id]/route.ts - Folder API → Input validation: validates writes
app/api/folders/route.ts - Folder API → Shared data store: reads and creates
app/api/folders/route.ts - Folder API → Broadcast bridge: announces creation
app/api/folders/route.ts - Folder item API → Shared data store: changes folders
app/api/folders/[id]/route.ts - Device API → Shared data store: manages devices
app/api/device/route.ts - File upload API → Input validation: checks upload
app/api/files/upload/route.ts - File upload API → File storage: stores bytes
app/api/files/upload/route.ts - File upload API → Shared data store: persists metadata
app/api/files/upload/route.ts - File upload API → Broadcast bridge: announces upload
app/api/files/upload/route.ts - File serving API → Shared data store: loads metadata
app/api/files/[id]/route.ts - File serving API → File storage: serves bytes
app/api/files/[id]/route.ts - Broadcast bridge → WebSocket event hub: forwards events
lib/broadcast.ts - Custom server → WebSocket event hub: mounts hub
server.mjs - WebSocket event hub → Shared data store: loads initial state
server/websocket/hub.mjs - Shared data store → PostgreSQL pool: queries database
server/store.mjs - PostgreSQL pool → PostgreSQL: connects
README.md - File storage → Host filesystem: reads and writes
README.md - Content and folders API → API responses: formats responses
app/api/content/route.ts