✨ What this is
One fast static page that makes a record easy to check. Every number is specific, linked to a public source where one exists, and unfinished work is marked with a hollow dot instead of being dressed up as a result.
- 🪶 No build step, no framework, no trackers, no third-party requests. Fonts are self-hosted.
- 🌗 Light and dark themes, keyboard-friendly, respects reduced motion, prints cleanly.
- 🧩 Works without JavaScript. The script only adds a nav highlight, an interactive hero figure, and copy buttons for BibTeX.
- ✅ Guarded by a checker that fails on a broken link, a phone number, an unexpected email, or placeholder text.
Open the live site and drag across the curves in the hero. They are the displacement, velocity and acceleration curves behind my Stanford project, and the banner above animates the same idea.
🧭 What is on the page
|
Section |
What it holds |
| 🏠 |
Hero |
Selected results, and a figure you can drag across to read displacement, velocity and acceleration |
| 🔬 |
Research |
Papers with a copy-BibTeX button, mentored research, projects |
| 🏆 |
Competitions |
Results with the field size where I know it |
| 🏗️ |
Building and leading |
AI Ethos, NextGenAI, CogArc, teams and service |
| 🏃 |
Outside the classroom |
Track, band, languages |
| 🎓 |
Academics |
School, scores, recognition, coursework capstones |
| 🔗 |
Sources |
Where each claim can be checked, or that records are available on request |
🎨 Design
|
|
| Type |
Newsreader for reading and display, Hanken Grotesk for labels and data |
| Palette |
     |
| Status dots |
● filled blue = done · ● filled teal = accepted · ○ hollow = ongoing, in progress, under review |
🔄 How a change ships
flowchart LR
A([✏️ Edit index.html]) --> B{{🛡️ tools/check.py}}
B -- problems --> A
B -- ok --> C([⬆️ git push to main])
C --> D([🌐 GitHub Pages])
classDef edit fill:#2545e6,stroke:#2545e6,color:#fff
classDef guard fill:#f2b632,stroke:#b9840a,color:#1a1300
classDef ship fill:#0b9d95,stroke:#0b9d95,color:#fff
class A edit
class B guard
class C,D ship
🗂️ Repository layout
index.html the whole site: semantic HTML, JSON-LD for search engines
404.html custom not-found page
aaryan-samanta-resume.pdf linked from the hero and contact section (keep this filename)
assets/css/style.css design tokens, layout, components, dark mode, print styles
assets/js/main.js optional enhancements (see above)
assets/fonts/ Newsreader + Hanken Grotesk (variable, latin subset, SIL OFL)
assets/img/ favicon, touch icon, social preview, animated README banner
robots.txt, sitemap.xml search engine hints
tools/check.py offline checks: links, ids, status labels, privacy, placeholders, dates
tools/build_resume.py regenerates the resume PDF in the site's own fonts
tools/build_banner.py regenerates the animated README banner
docs/CONTENT-GUIDE.md how to add or change an entry, and the rules I follow
.github/workflows/check.yml runs tools/check.py on every push and pull request
🚀 Preview locally
python3 -m http.server 8000
# open http://localhost:8000
python3 tools/check.py # run before every commit
✍️ Updating content
Everything lives in index.html. Each entry is one <article class="row"> (Research, Building, Outside the classroom) or one <li> (Competitions). Copy a nearby entry and edit it. The full guide, including the status labels and the rules for promoting an item from “in progress” to “done”, is in docs/CONTENT-GUIDE.md.
After any edit that changes content:
- Update the footer
<time> and the JSON-LD dateModified in index.html.
- Update
lastmod in sitemap.xml (tools/check.py fails if these disagree).
- If the change belongs on the resume, edit
tools/build_resume.py and run it.
- If a headline result changed, edit the
facts chips in tools/banner/banner.html and run tools/build_banner.py.
- Run
python3 tools/check.py, then click any external link you added or changed.
Only completed results go in as results. Plans and targets do not. If two files disagree about a number, settle it once and update everything that repeats it.
📄 Rebuilding the resume PDF
pip install -r tools/requirements.txt
python3 tools/build_resume.py
This overwrites aaryan-samanta-resume.pdf in place, so links to it keep working. The PDF deliberately has no phone number and no reference contact details.
🎞️ Rebuilding the banner
pip install playwright pillow && playwright install chromium
python3 tools/build_banner.py
Renders 72 frames of tools/banner/banner.html and writes assets/img/readme-banner.gif (about 0.25 MB).
🌐 Deploying
This repository is a GitHub Pages user site, so it must be named exactly aaryansamanta.github.io.
Settings, Pages, Source: Deploy from a branch, branch main, folder / (root). The site is live within a minute of each push.
Do not add a CNAME file unless you intend to move the site to a custom domain. It would redirect this address.
⚖️ License
- Code (HTML structure, CSS, JavaScript, tools): MIT, see
LICENSE.
- Written content, resume and personal data: all rights reserved.
- Fonts: SIL Open Font License, see
assets/fonts/.
评论