All projects

Web apps

Asterix OS

A desktop operating system in your browser — and the home of every astrx.dev product.

Why it existsA list of products is flat. Asterix OS lets you open each one in its own window — README, code and a terminal included — and poke around the way you would on a real desktop.

A browser-based desktop with draggable windows, a terminal, a virtual file system and a live GitHub file explorer — where each astrx.dev product opens in its own window.

Stars
0
Forks
1
Last push
Updated 11 days ago

Languages

TypeScript94.9%
CSS5.0%
JavaScript0.1%
README.md

astrx.dev — Product Showcase

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:

URLWhat it is
/Products website (default) — fast, scannable, mobile-first.
/osDesktop OS — an interactive desktop with draggable windows, a terminal, native-feeling apps and a BIOS boot sequence.
/projectsThe 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).


Features

📇 Products website (/)

  • 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.

🗂️ Updating the project list

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.

🖥️ OS Shell

  • 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).

🪟 Window System

  • Draggable & resizable windows via Framer Motion.
  • Z-index focus snapping on click.
  • Minimize, Maximize, and Close controls.
  • Windows restore from taskbar on click.

📦 Built-in Apps

AppDescription
TerminalFull command-line interface. Commands: help, ls, whoami, open <repo>, sysinfo, theme, clear. Auto-runs whoami after boot.
My ComputerLive GitHub file explorer — browse repos, drill into folders, view files.
Document ViewerRenders Markdown, code files, images, and text fetched from GitHub.
Project ViewerShows README, commit timeline, and language bar for a repo.
Browser Previeweriframe-based live demo viewer for project homepages.
NotepadMulti-note editor with localStorage persistence. Ctrl/⌘+S to save.
Image ViewerZoom (scroll), pan (drag), rotate, gallery mode, download.
SettingsPersonalization / theme switcher.
PropertiesSystem info panel.

🎨 Design

  • 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, .depth in globals.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 under prefers-reduced-motion.
  • Carbon theme with cyan-glowing and emerald-burnt accent palette.
  • Glassmorphism window chrome.
  • Framer Motion animations throughout.
  • CRT scanlines, vignette, custom cursor.
  • Google Fonts: Geist Sans + Geist Mono.

⌨️ Command Palette

Press Ctrl+K / ⌘K to open the global command palette. Search repos, open apps, switch themes.


Tech Stack

  • 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

Getting Started

npm install
npm run dev

Open http://localhost:3000.

Environment Variables

GITHUB_TOKEN=your_github_pat   # Required for GitHub API requests

Create a .env.local file in the project root with the above variable.


Project Structure

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

Deployment

Deploy on Vercel — add GITHUB_TOKEN as an environment variable in the project settings.