llms.txt
Compare with other sites' llms.txt files →# Basel Ashraf
> Basel Ashraf Fikry is a software engineer and undergraduate student building production
> systems alone. He ships layout engines, browser physics simulations, SaaS products, and
> open-source tools - each one instrumented, measured, and backed by real usage figures.
Canonical URL: https://baselashraf.com
GitHub: https://github.com/BaselAshraf81
ORCID: https://orcid.org/0009-0009-3441-6196
Resume (PDF): https://baselashraf.com/resume.pdf
Resume (Text): https://baselashraf.com/resume.txt
Contact: hello@baselashraf.com
Last updated: 2026-09-16
## Key Projects & Case Studies
### wordwar
URL: https://baselashraf.com/wordwar/
Source: https://github.com/BaselAshraf81/wordwar
A browser battle simulator: type any two armies ("100 men" vs "1 gorilla", "50 geese with
knives" vs "a medieval knight") and watch wobbly ragdolls fight it out. Jev, TypeSafe's
typed-decision model, answers about 90 closed-list questions per phrase (body frame, limbs,
material, attacks, weaknesses, size, weight, bravery); code turns the answers into jointed
bodies and a deterministic Rapier 2D simulation decides the winner. The AI never sees the
opponent, so it cannot pick who wins. Same seed, same fight on every device; share links carry
the designed armies, so replays never call the AI again.
### sensortap
URL: https://baselashraf.com/sensortap/
Case Study: https://baselashraf.com/work/sensortap.html
Source: https://github.com/BaselAshraf81/sensortap
A Python framework that discovers every sensor a computer has, camera, microphone, motion,
battery, radios, and Windows hardware telemetry, and reads all of them through one schema.
One adapter per sensor family, none aware of the others; the registry loads whatever it finds,
runs discovery concurrently under a shared timeout, and hands back one flat, typed list.
Verified live on a Dell G3 3779 by running the actual CLI:
- 86 sensors discovered across 16 kinds
- 10 of 10 backends loaded, 0 failing
- 193 tests, none requiring physical sensor hardware in the default run
Enumerating sensors never opens a device or triggers an OS permission prompt, even for a
camera. Reading or streaming a camera, microphone, or touchpad capacitive-image sensor
requires explicit consent for that exact sensor id first.
Windows today, nine adapters shipped, all against real hardware. Linux is designed into the
architecture but not yet built; it is the clearest open contribution.
Free and open source, MIT licence.
### WinDuo
URL: https://baselashraf.com/winduo/
Case Study: https://baselashraf.com/work/winduo.html
Source: https://github.com/BaselAshraf81/winduo
Brings the iPhone Duo fold transition to Windows laptops: the screen tilts, blurs, and dims
as the lid closes, the way Mac Duo does it on MacBooks using their lid angle sensor. Windows
laptops mostly have no such sensor, so WinDuo recovers the lid angle from the webcam instead,
using phase correlation on the vertical image shift a closing lid produces (roughly fifteen
pixels per degree). Each frame is compared against the one before it and discarded; nothing
is recorded and nothing leaves the machine.
Verified by 118 tests. Windows 10 version 2004 or later, and Windows 11. Free for personal use
under PolyForm Noncommercial.
### Roadwright
URL: https://baselashraf.com/roadwright/
Case Study: https://baselashraf.com/work/roadwright.html
Source: https://github.com/BaselAshraf81/roadwright
A free browser tool that solves the road an arbitrary drawn wheel rolls on while its axle stays
at a constant height. A square rolls on a row of inverted catenaries; any other shape rolls on
something else. Both directions of the relation are quadratures rather than iterative solves:
x(theta) = integral of r dtheta with y = -r, and inverted, theta(x) = integral of dx / (-y). The
road is therefore recomputed continuously while the axle is dragged. Zero runtime dependencies,
18 kB gzipped, no backend.
Verified against closed form, by test on every commit:
- A square of half-side a returns y = -a*cosh(x/a) to better than 1 part in 10^6
- A circle returns a flat road, to 5e-6 at 2048 segments
- Road arc length equals wheel perimeter, which is what rolling without slipping means
- Wheel to road to wheel round-trips
- 79 tests total
Two results worth citing:
- The road's horizontal period is NOT the wheel perimeter. For a square of half-side a it is
8*a*ln(1 + sqrt(2)), about 7.0509a, against a perimeter of 8a. Only a circle makes them agree.
- Rut depth does not predict whether a wheel can be built. A rounded rectangle has deeper ruts
than an equilateral triangle and rolls cleanly, because what binds a wheel is corner sharpness.
Interference is therefore measured directly: 0% for a circle and square, 0.01% for a rounded
rectangle, 4.7% for an equilateral triangle, and 21.5% for a five-pointed star. The last two
cannot be built, which matches the known fact that a rolling equilateral triangle jams.
Prior art: Leon Hall and Stan Wagon, "Roads and Wheels", Mathematics Magazine 65 (1992);
G. B. Robison derived the general equations in 1960; Wagon and Loren Kellen built a
square-wheeled bicycle at Macalester College in 1997; MoMath and the Exploratorium exhibit one.
### Eigendrum
URL: https://eigendrum.com
Case Study: https://baselashraf.com/work/eigendrum.html
DOI: https://doi.org/10.5281/zenodo.22019539
Cite as: Ashraf, B. (2026). Eigendrum: Hearing the shape of a drum. Zenodo. doi:10.5281/zenodo.22019539
A free browser tool that meshes any drawn outline, solves the Dirichlet eigenvalue problem for
the Laplacian on that exact region with P1 finite elements, and synthesises every frequency it
finds. Nothing is sampled. A 2,051-unknown drum solves in ~800 ms in a browser Web Worker with
zero dependencies and no backend.
Verified accuracy against closed-form spectra:
- Unit square: 0.160% worst error over 8 modes at 6,000 nodes
- Unit disk: 0.192% worst error
- Right isosceles triangle: 0.227%
- Rectangle 1.5×0.8: 0.233%
Includes both Gordon-Webb-Wolpert isospectral drums. Eigendrum reports their 16 lowest
frequencies agree to within 1.07×10⁻⁷ percent - you can hear a theorem be true.
Featured in 52+ named sources across 8 languages:
- Wikipedia external links (Hearing the shape of a drum)
- Hacker News front page ×2
- kottke.org editorial
- r/InternetIsBeautiful, r/oddlysatisfying
- Sidebar.io newsletter
- Daily Tech Feed, Agent Amigos (YouTube)
- International: drweb.de (DE), Vostok Magazine (RU), diginews.fr (FR), Meneame (ES),
SheepNav (ZH), TheNote.app (JA)
- Archived by Zenodo (OpenAIRE), cited with CITATION.cff
Source: https://github.com/BaselAshraf81/eigendrum
Tech: Vanilla JavaScript, Web Workers, Web Audio API, zero dependencies
---
### LayoutSans
URL: https://github.com/BaselAshraf81/layout-sans
Case Study: https://baselashraf.com/work/layout-sans.html
npm: https://www.npmjs.com/package/layout-sans
A TypeScript flex/grid layout engine that runs without a DOM. Takes a tree of boxes with flex
and grid rules, returns exact pixel positions for every one of them. Ships ~17 kB gzipped
vs Meta Yoga's 300+ kB. Benchmarks (measured, reproducible):
- 100 boxes: 0.27 ms (vs Yoga 0.80 ms, DOM 8.0 ms)
- 10,000 boxes: 4.82 ms (vs Yoga 8.0 ms, DOM 800 ms)
- 100,000 rows variable height: 46 ms (vs Yoga 85 ms, DOM crashes)
Version 0.2 adds canvas text interaction: selection, Ctrl+F search, clipboard, hyperlinks,
and screen-reader accessibility - sitting on top of chenglou/pretext for measurement.
67 GitHub stars. TypeScript. MIT licence. 0 dependencies.
---
### Prolific Tea
URL: https://prolifictea.com
Case Study: https://baselashraf.com/work/prolific-tea.html
A review platform for Prolific research participants to rate researchers on fairness and
rejection behaviour. Built alone with Next.js, a Chrome extension, PWA push notifications,
image uploads, threaded comments, and moderation tooling.
- 100,000+ page views
- 1,582 researchers indexed
- 5 languages
---
### Photophane
URL: https://baselashraf81.github.io/photophane/
Case Study: https://baselashraf.com/work/photophane.html
Computes a clear 3D-printable plate that projects a photograph via refracted light (caustic).
72 upvotes on r/photogrammetry. The exact forward optics algorithm powers the live Caustic
simulation on the baselashraf.com homepage.
---
### Systems, Tools & Findings
- **holystitch** - MCP tool converting Google Stitch designs to React/Next.js with zero AI
tokens. 23 stars. https://github.com/BaselAshraf81/holystitch
- **fastemporal** - Luxon + Temporal API in Rust, 40× faster, 332 tests.
https://docs.rs/fastemporal
- **Legal document RAG** - Retrieval over 25,303 documents with hybrid search,
230+ concurrent users on a single T4 GPU with a custom request queue.
- **Nextron PR #531** - Upgraded Electron+Next framework to Next 16 and React 19 across 33 files.
- **fx-inject-shim** - Firefox 152 compat shim for tabs/scripting injection APIs.
21 upvotes on r/firefox.
- **Stored XSS in M-Pesa** - Found via font descriptor injection in PDF receipts. Reported
and accepted through HackerOne.
## Background
- BSc Computer Engineering and Software Systems - University of East London &
Ain Shams University (dual degree, expected Nov 2026)
- Exchange year - Hanyang University, Seoul, GPA 4.0 / 4.5
- Graduate summer school - Università di Pisa, Human-Centric ICT for Industry 5.0,
graded 29/30 on scholarship
## Skills
Languages: TypeScript, JavaScript, Rust, Python, Java, SQL, C/C++
Systems: Finite Element Method (FEM), Web Workers, Canvas 2D/WebGL, MCP Servers, FAISS, Docker, Linux
Web: Next.js, React, Node.js, Web Audio API, Chrome Extensions, Tailwind CSS, PostgreSQL, Supabase
Security: Burp Suite, OWASP, Web Security Research, Font & Parser Exploitation, HackerOne Bug Bounty
## Links
- Portfolio: https://baselashraf.com
- GitHub: https://github.com/BaselAshraf81
- LinkedIn: https://www.linkedin.com/in/basel-askar/
- ORCID: https://orcid.org/0009-0009-3441-6196
- Eigendrum: https://eigendrum.com
- Eigendrum DOI: https://doi.org/10.5281/zenodo.22019539