Rudramani Singha Website

Personal website for singha.io.

The site is a Vite + React project with a monochrome terminal interface and direct canvas animations. Source files live in the repository; GitHub Actions builds them into dist/ and deploys that artifact to GitHub Pages.

How Publishing Works

style is the main branch.

When you push to style, GitHub Actions runs:

npm ci
npm run build

That creates dist/, uploads it as a Pages artifact, and deploys it to singha.io.

Do not commit dist/. It is generated by the Action.

Local Development

Install dependencies once:

npm install

Start the local dev server:

npm run dev

Vite will print a local URL, usually:

http://localhost:5173/

Build locally before pushing:

npm run build

Preview the production build:

npm run preview

Common Workflow

git switch style
npm run dev
npm run build
git status
git add .
git commit -m "Describe the change"
git push

After the push, check the deployment here:

Deploy Static Site workflow

Important Files

• index.html: Vite HTML entrypoint and metadata
• src/main.jsx: React app, canvas animations, and locked homepage content
• stylesheet.css: site styling imported by the React app
• images/: profile and project images
• 404.html: custom not-found page
• CNAME: custom domain, singha.io
• .github/workflows/pages.yml: GitHub Actions build and deploy workflow
• tools/copy-static.mjs: copies static Pages files into dist/ after Vite builds
• AGENTS.md: instructions for coding agents working in this repo

Deployment Settings

GitHub repository settings should be:

• Default branch: style
• Pages source: GitHub Actions
• Custom domain: singha.io
• Pages environment: allow deployments from style

Notes

• This repo does not use Jekyll.
• React is used for the homepage UI; Vite handles local development and production builds.
• node_modules/ and dist/ are ignored.
• Node is pinned in .node-version.
• The production site is made by GitHub Actions, not by manually uploading local files.