Open database and web application for Near-Edge X-ray Absorption Fine Structure (NEXAFS) spectroscopy.

This repository contains the Next.js app, Prisma schema, and contributor documentation for X-ray Atlas.

• src/app - Next.js App Router (browse, contribute, molecules, facilities, API routes)
• src/server - tRPC routers, authentication, and server-side data access
• src/components - Shared UI, plots, forms, and layout
• prisma - Database schema and migrations

Report an Issue

X-ray Atlas is open source and we welcome contributions from the community.

1. Fork and clone the repository
2. Install Bun and Node.js 24 or newer (see package.json engines)
3. Install dependencies with bun install
4. Follow CONTRIBUTING.md for environment setup, database setup, and local OAuth
5. Run bun run check before opening a pull request
6. Open a pull request with a clear description of the change

We allow AI-assisted development, but contributors must follow the policy in CONTRIBUTING.md, including the required AI Role section in pull requests (3 levels) and the Cursor-first editing workflow.

Cursor is the intended tool for editing/vibe coding in this repo; do not edit maintainer-owned .cursor/ configuration in your PR.

Application code is licensed under the MIT License. Contributed datasets are licensed under CC BY 4.0.

Each dataset has a minted DOI. When using X-ray Atlas data, cite:

Individual dataset:

[Dataset Name] [DOI]. Adapted from [Original Publication]. Hosted by X-Ray Atlas.

Entire collection:

X-Ray Atlas [Collection DOI]. Accessed [Date].

See dataset landing pages for full citation details and examples.