AGENTS.md

AGENTS.md

Cursor Cloud specific instructions

This is a Jekyll-based academic portfolio website (Academic Pages template). It is a purely static site with no backend services, databases, or APIs.

Services

ServiceHow to runPort
Jekyll dev serverbundle exec jekyll serve -l -H localhost4000

Running the dev server

bundle exec jekyll serve -l -H localhost

The site will be available at http://localhost:4000/. LiveReload runs on port 35729. Note that _config.yml changes require a server restart (not picked up by live reload).

JS build (optional)

npm run build:js minifies JS assets into assets/js/main.min.js. This is only needed if JS source files under assets/js/ are modified. A pre-built version is already committed.

Gotchas

  • There is no Gemfile.lock committed. bundle install resolves dependencies fresh each time, which may occasionally pull breaking versions. The github-pages gem pins most dependencies.
  • Ruby gems install system-wide (under /var/lib/gems/), so sudo is required for gem install and bundle install.
  • The _config.yml url field is set to https://rishavsen1.github.io. During local development, Jekyll overrides this to http://localhost:4000 automatically.
  • No lint or test framework is configured in this repository. Validation is done by building the site (bundle exec jekyll build) and visually inspecting it.