Aditya Palve - Personal Website

A minimal, text-first personal website built with Astro.

Features

• Home – Introduction, a live postcard of the village, and recent writing
• Village – My work as a small pixel-art village you walk around
• Experience – The same story as a plain page, for anyone who skips the walk
• Writing – Blog posts and long-form content
• Bookshelf – Books I've read as a shelf of generated spines, linked to my notes
• Footpaths – Map of places I've visited, generated from photo EXIF data
• Contact – Ways to get in touch

Development

# Install dependencies
npm install

# Start dev server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

Adding Content

Everything on the site is generated from files in the repo. Nothing is hand-edited in src/pages.

Writing (from Obsidian)

Posts live in src/content/writing/*.md and are published from the Obsidian vault:

1. In any note, add publish: true to the frontmatter. Optional: title, date, description, tags, slug. Without a date the first publish date is kept.

2. Run:

   npm run notes:publish

3. Commit the generated files.

The vault defaults to ~/irendel; override with OBSIDIAN_VAULT=/path npm run notes:publish. Wikilinks to other published notes become site links, other wikilinks become plain text, and embedded images are copied next to the post. Removing publish: true and re-running deletes the published copy.

Books

Books live in src/content/books/*.md. Frontmatter:

title: The Power Broker
author: Robert Caro
year: 2024            # year finished
isbn: "9780394720241" # optional
status: finished      # reading | finished | abandoned
pages: 1246           # optional, drives spine thickness
spine: "#5a2e2e"      # optional, spine color (derived from the title otherwise)
description: One line for the home page

The markdown body is your notes. A book with a body gets a page and a clickable spine on the shelf; a book without one is just a spine. Books can also be published from Obsidian: set type: book alongside publish: true and the fields above.

Footpaths / Photos

Drop photos in src/assets/footpaths/<Place Name>/. The build reads GPS and dates from EXIF and writes src/data/footpaths.json automatically (npm run photos:import to run it by hand). See src/assets/footpaths/README.md for overrides and captions.

The village (/village)

A small pixel-art village built from the experience data. Each of the four cases in src/data/experience.json becomes a hut whose keeper reads out that case's points one bullet at a time; the keeper at the workshop stall by the pond covers side, with links. Art is drawn in code in src/scripts/village/; there are no image assets.

The game fills the window. The home page shows a non-interactive postcard of the same village (postcard.ts), and /experience renders the full experience.json as a plain page; both "skip" links point there.

The map also has an eastern lake, a small island, and a southern grove:

• Companion: face Squirtle northwest of the plaza and press Enter (or touch A). Squirtle joins you and follows one tile behind on land.
• Bicycle: collect the bicycle west of the plaza. Press B or the Cycle button to toggle faster land travel. Entering water dismounts the bicycle.
• Surf: with Squirtle, walk into water to surf. Walk onto land to come ashore. Without Squirtle, water blocks movement; interact with it for a hint.
• Frostfall Cave: surf to the island and walk into the opening in its northern ridge. This original Icefall-inspired cavern has sliding ice, rocky stopping points, an animated waterfall, and a surfable pool. On ice you keep moving straight until reaching dry ground or an obstacle; after stopping, choose another direction. Bicycles stay dismounted inside. Walk through the glowing southern doorway to return to the island. Your companion, bicycle, visited huts, and discoveries are retained when changing areas.
• Secrets: read the island lookout, grove, and frozen chamber signs to discover three hidden messages. Re-reading a sign does not increase the discovery count.

Movement uses arrows or WASD; Enter, Space, E, or Z interacts; Escape closes dialogue. Touch controls provide a d-pad and A, plus a Cycle button after collecting the bike. Companion, bicycle, and discovery progress last for the current visit and reset on reload.

Reusing the game with p5.js

The current renderer uses Canvas 2D, not p5.js. A p5 migration does not require rebuilding the whole game:

• map.ts owns village terrain and locations; cave-map.ts defines the cave interior.
• adventure.ts owns movement, collision, companion following, unlocks, ice sliding, and area-transition state, without DOM or drawing dependencies.
• sprites.ts, tiles.ts, and adventure-sprites.ts generate cached canvas sprites.
• dialog.ts and the page's HTML HUD can stay outside the sketch, keeping text and controls accessible.

Use a p5 instance-mode sketch for this page. Its draw loop can update the adventure and pass its Canvas 2D drawingContext to createScene().draw, reusing the existing art. The canvas creation/sizing, input binding, timing, and sketch teardown need adapting; the Astro markup is not itself a p5 component. The home postcard already shares the world and renderer and remains non-interactive.

Checks

npm run lint    # oxlint with the vendored anti-slop rules (tools/oxlint/anti-slop)
npm run check   # astro check (TypeScript)

Original Quartz Site

The original Quartz-based site is preserved in the stash/ folder.

Tech Stack

• Astro – Static site generator
• Leaflet – Interactive maps
• Obsidian – Where the writing happens; published with npm run notes:publish

Commands

Command	Action
npm install	Installs dependencies
npm run dev	Starts local dev server at localhost:4321
npm run build	Build your production site to ./dist/
npm run preview	Preview your build locally, before deploying
npm run astro ...	Run CLI commands like astro add, astro check
npm run astro -- --help	Get help using the Astro CLI

👀 Want to learn more?

Feel free to check our documentation or jump into our Discord server.