A simple, clean, fast browser for the AtmosphereConf(2026) VODs
docs: add project docs and design context (AI-assisted)
+76
+17
.impeccable.md
+17
.impeccable.md
···
1
+
## Design Context
2
+
3
+
### Users
4
+
Developers, researchers, and ATmosphereConf attendees browsing conference talks across desktop and mobile. They need to quickly scan talks, find relevant sessions by title, and jump into playback with minimal friction.
5
+
6
+
### Brand Personality
7
+
Atmospheric, focused, and technical. The experience should feel calm and immersive while still snappy and practical for heavy browsing.
8
+
9
+
### Aesthetic Direction
10
+
Dark, glassy, aurora-inspired interface with subtle motion and texture. Monospace-first typography per product requirement, translucent surfaces over a deep blue/teal/purple backdrop, and restrained interactive glow for key controls.
11
+
12
+
### Design Principles
13
+
1. Keep browsing fast and legible first, then layer atmosphere through motion and texture.
14
+
2. Use glass treatment purposefully for navigational and content surfaces, not decorative overuse.
15
+
3. Maintain strong interaction clarity with touch-friendly controls and immediate feedback.
16
+
4. Prioritize resilient UX: clear loading, graceful failures, and predictable recovery.
17
+
5. Preserve mobile parity with desktop through adaptive navigation and gesture support.
+21
LICENSE
+21
LICENSE
···
1
+
MIT License
2
+
3
+
Copyright (c) 2026 Jack
4
+
5
+
Permission is hereby granted, free of charge, to any person obtaining a copy
6
+
of this software and associated documentation files (the "Software"), to deal
7
+
in the Software without restriction, including without limitation the rights
8
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+
copies of the Software, and to permit persons to whom the Software is
10
+
furnished to do so, subject to the following conditions:
11
+
12
+
The above copyright notice and this permission notice shall be included in all
13
+
copies or substantial portions of the Software.
14
+
15
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+
SOFTWARE.
+38
README.md
+38
README.md
···
1
+
# Atmosphere VODs
2
+
3
+
Atmosphere VODs is a minimalist glassy PWA for browsing ATmosphereConf 2026 talks from the
4
+
Streamplace AT Protocol VOD beta API.
5
+
6
+
## What it includes
7
+
8
+
- React + Vite + TypeScript app with Tailwind + shadcn-style UI primitives
9
+
- PDS-aware data fetching: resolves the repo DID in PLC directory, then fetches records from that PDS
10
+
- HLS playback via `hls.js` with custom controls and mobile swipe-down dismiss
11
+
- Search by talk title with instant client-side filtering
12
+
- Mobile-first navigation: bottom tabs on mobile, sidebar on desktop
13
+
- PWA setup with `vite-plugin-pwa` and Workbox runtime caching
14
+
15
+
## Run locally
16
+
17
+
```bash
18
+
npm install
19
+
npm run dev
20
+
```
21
+
22
+
## Build for production
23
+
24
+
```bash
25
+
npm run build
26
+
```
27
+
28
+
## Deploy to Vercel
29
+
30
+
1. Push this repo to GitHub.
31
+
2. In Vercel, import the repository.
32
+
3. Deploy with defaults, or run `vercel deploy` from your terminal.
33
+
34
+
No environment variables are required because all APIs are public.
35
+
36
+
## License
37
+
38
+
MIT