Official website for Queen's University's BAM Laboratory, directed by Dr. Farhana H. Zulkernine.

This project is built using Next.js (React), Tailwind CSS for styling, and Shadcn UI components. It is statically generated and deployed to GitHub Pages.

To run the project locally, ensure you have Node.js (v18+) and PNPM installed.

pnpm install

pnpm dev

Open http://localhost:3000 with your browser to see the result.

To test the production build locally:

pnpm build
pnpm start

The website's content is not stored in a database. Instead, it uses structured TypeScript files to manage data easily without needing a backend.

All data files are located in src/lib/.

1. Open the relevant file in src/lib/.
2. Add a new object to the array or modify existing fields.
3. Save the file.
4. If the dev server is running, the changes will reflect immediately.

Static assets are stored in the public/ directory.

• People: Store headshots in public/imgs/people/.
• Logos: Store sponsor or partner logos in public/imgs/logos/.
• General: Store other site images in public/imgs/.
• Reference: /imgs/people/john_doe.jpg

• Store PDF files for publications here.
• Reference: /papers/paper_name.pdf

• Store templates, handbooks, and other resources for the internal Wiki here.
• Reference: /wiki/template_name.docx (Note: some legacy code might not need the leading slash, check specific usage)

Important: Assets in the public/ folder are served at the root URL.

This website uses GitHub Actions to automatically build and deploy to GitHub Pages.

You simply need to push your changes to the main branch.

1. Commit your changes:

   git add .
   git commit -m "Updated lab news and publications"

2. Push to GitHub:

   git push origin main

1. The GitHub Action defined in .github/workflows/nextjs.yml will trigger.
2. It will install dependencies, build the static site, and export it to the ./out folder.
3. The content is then deployed to the gh-pages environment automatically.

Note: Ensure your repository Settings > Pages is set to deploy from GitHub Actions, not a branch.