The showcase for products shipped under the astrx.dev brand — NexQL, pacpad, drawdown and more. It is about the products, not a person: the author's personal résumé lives at me.astrx.dev. Built with Next.js 16 (App Router) that comes in two flavours:
| URL | What it is |
|---|---|
/ |
Products website (default) — fast, scannable, mobile-first. |
/os |
Desktop OS — an interactive desktop with draggable windows, a terminal, native-feeling apps and a BIOS boot sequence. |
/projects |
The products website, never redirected (stable link from inside the OS). |
Visitors can flip "Open the desktop OS by default" on the website or in the OS Welcome window. The choice is stored
in the asterix-default-view cookie, and src/proxy.ts redirects / → /os for those visitors (add ?view=site to
override).
- Server-rendered, SEO-friendly, mobile-first page for visitors who want the facts fast: what each product does, where to try it, and how to get in touch.
- Featured projects with highlights, stack and links, plus a filterable/searchable list of everything.
- Per-project pages at
/projects/<slug>with README, recent commits and language breakdown. Legacy URLs (e.g./projects/PgStudio) redirect. - Linked from the OS login screen, the Welcome app, and a keyboard skip link on
/os.
Projects are curated in src/lib/projects.ts — the single source of truth for what is showcased and how it is described.
Projects can live under any GitHub owner (dev-asterix, NexQL-OSS, ric-v, …). Live stars / last-push dates are
layered on at request time, and every page still renders if the GitHub API is rate-limited or down.
Projects with a group (e.g. "nexql" for everything under NexQL-OSS) are shown together in a spotlight panel
described by PROJECT_GROUPS; everything else appears in the filterable Projects grid. In the desktop OS, any
registry project without a hand-written demo gets a generated overview window.
To add a project, append an entry with slug, owner, repo, tagline, description, highlights, category,
language, stack, and optionally featured, liveUrl, links, icon, and demoId (a key in src/lib/demoContent.ts
for the interactive in-OS demo). Brand name, description and contact links live in src/lib/site.ts.
- Boot Sequence — Fake BIOS/kernel log stream on first visit, with a progress bar and CRT scanline overlay. Press any key or tap to skip; skipped automatically on repeat visits (sessionStorage).
- MenuBar — Fixed top bar with live clock (weekday + time), WiFi bars, real Battery API indicator, ThemeToggle, and a Power button for reboot.
- Taskbar / Dock — Bottom dock with quick-launch icons and running app indicators. Click a running app to restore/focus it.
- Desktop Drag-Select — Click-drag on empty desktop to draw a translucent selection box.
- Shutdown Animation — Classic CRT power-off effect (vertical collapse → scan line → black) before reboot.
- Context Menu — Right-click desktop for quick app launchers (Terminal, My Computer, Notepad, Settings, Properties).
- Draggable & resizable windows via Framer Motion.
- Z-index focus snapping on click.
- Minimize, Maximize, and Close controls.
- Windows restore from taskbar on click.
| App | Description |
|---|---|
| Terminal | Full command-line interface. Commands: help, ls, whoami, open <repo>, sysinfo, theme, clear. Auto-runs whoami after boot. |
| My Computer | Live GitHub file explorer — browse repos, drill into folders, view files. |
| Document Viewer | Renders Markdown, code files, images, and text fetched from GitHub. |
| Project Viewer | Shows README, commit timeline, and language bar for a repo. |
| Browser Previewer | iframe-based live demo viewer for project homepages. |
| Notepad | Multi-note editor with localStorage persistence. Ctrl/⌘+S to save. |
| Image Viewer | Zoom (scroll), pan (drag), rotate, gallery mode, download. |
| Settings | Personalization / theme switcher. |
| Properties | System info panel. |
- Light & dark modes — follows the system by default; Light / System / Dark switch on the website, sun/moon toggle in the OS menu bar (they share one setting). Switching animates as a circular reveal from the control you clicked (View Transitions API), with a colour cross-fade fallback and an instant swap for reduced-motion users.
- One light source, top-left — surfaces (
.surface,.depthinglobals.css) get a bright top/left edge, a soft corner glow and a shadow cast down-right; OS windows add a faint glare. Tuned per mode via--depth-*variables. - Hover & motion — cards lift with an accent edge and a cursor-following spotlight (
SurfaceSpotlight); buttons lift and press; staggered entrance on load and CSS scroll-reveal (.rise,.reveal), all disabled underprefers-reduced-motion. - Carbon theme with
cyan-glowingandemerald-burntaccent palette. - Glassmorphism window chrome.
- Framer Motion animations throughout.
- CRT scanlines, vignette, custom cursor.
- Google Fonts: Geist Sans + Geist Mono.
Press Ctrl+K / ⌘K to open the global command palette. Search repos, open apps, switch themes.
- Framework: Next.js 16 (App Router, RSC)
- Styling: Tailwind CSS v4
- Animation: Framer Motion
- State: Zustand (with localStorage persistence)
- Icons: Lucide React
- API: Next.js Route Handlers proxying GitHub REST API
npm install
npm run devOpen http://localhost:3000.
GITHUB_TOKEN=your_github_pat # Required for GitHub API requestsCreate a .env.local file in the project root with the above variable.
src/
├── app/
│ ├── page.tsx # "/" — projects website (default landing)
│ ├── os/page.tsx # "/os" — desktop OS (server component, fetches repos)
│ ├── projects/ # "/projects" + /projects/[repo] detail pages
│ ├── sitemap.ts, robots.ts # SEO
│ └── api/github/ # GitHub API proxy routes
├── components/
│ ├── apps/ # OS applications
│ │ ├── TerminalApp.tsx
│ │ ├── FileExplorer.tsx
│ │ ├── DocumentViewer.tsx
│ │ ├── ProjectViewer.tsx
│ │ ├── BrowserPreviewer.tsx
│ │ ├── NotepadApp.tsx
│ │ ├── ImageViewer.tsx
│ │ ├── SettingsApp.tsx
│ │ └── PropertiesApp.tsx
│ └── ui/ # OS shell components
│ ├── DesktopManager.tsx
│ ├── Window.tsx
│ ├── MenuBar.tsx
│ ├── Taskbar.tsx
│ ├── CommandPalette.tsx
│ ├── BootSequence.tsx
│ ├── BootWrapper.tsx
│ ├── ShutdownOverlay.tsx
│ └── DesktopDragSelect.tsx
├── store/
│ └── useOSStore.ts # Zustand OS state (windows, repos, settings)
├── proxy.ts # Sends "/" to "/os" for visitors who chose the OS by default
└── lib/
├── projects.ts # Curated project registry (edit this to update the project list)
├── site.ts # Brand name, description, contact links
├── projectStats.ts # Live GitHub stats for registry projects (server)
├── github.ts # GitHub API helpers
└── sysinfo.ts # System info helpers
Deploy on Vercel — add GITHUB_TOKEN as an environment variable in the project settings.