Add project README replacing Vite boilerplate

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,27 @@
+---
+name: Bug report
+about: Report something that isn't working correctly
+title: ''
+labels: bug
+assignees: ''
+---
+
+**What happened?**
+A clear description of the bug.
+
+**Steps to reproduce**
+1. Go to '...'
+2. Click on '...'
+3. See error
+
+**Expected behavior**
+What should have happened instead.
+
+**Screenshots**
+If applicable, add screenshots.
+
+**Environment**
+- Browser and version:
+- Device (desktop/mobile):
+- Offline or online:
+- Language setting:

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature request
+about: Suggest a new feature or improvement
+title: ''
+labels: enhancement
+assignees: ''
+---
+
+**What problem does this solve?**
+Describe the need or gap this feature addresses.
+
+**Proposed solution**
+How you'd like it to work.
+
+**Alternatives considered**
+Other approaches you've thought about.
+
+**Additional context**
+Anything else -- screenshots, links, related issues.

.github/pull_request_template.md

@@ -0,0 +1,19 @@
+## What does this PR do?
+
+Brief description of the change.
+
+## Why?
+
+Context or motivation for the change.
+
+## How to test
+
+Steps to verify this works correctly.
+
+## Checklist
+
+- [ ] Tested offline (no network)
+- [ ] Tested across supported languages (if applicable)
+- [ ] Accessibility checked (keyboard nav, screen reader, contrast)
+- [ ] No new lint warnings (`npm run lint`)
+- [ ] Build passes (`npm run build`)

.oxlintrc.json

@@ -219,6 +219,6 @@
     "**/ui/breadcrumb.tsx",
     "**/ui/progress.tsx",
     "**/ui/resizable.tsx",
-    "Docs/**"
+    "docs/**"
   ]
 }

CONTRIBUTING.md

@@ -0,0 +1,52 @@
+# Contributing to CALMe
+
+CALMe is a crisis intervention tool. Contributions here have real impact on people in real distress. We take that seriously, and we appreciate that you do too.
+
+## Getting set up
+
+```bash
+git clone https://github.com/CALMe25/CALMe.git
+cd CALMe
+npm install
+npm run dev
+```
+
+The app runs at `http://localhost:5173`. Everything runs locally -- no backend, no API keys, no external services.
+
+## Development workflow
+
+1. Create a branch from `main`
+2. Make your changes
+3. Run `npm run lint` and `npm run build` before committing
+4. Open a pull request using the PR template
+
+Commits are linted on pre-commit via Husky + lint-staged. If the hook fails, fix the issue rather than skipping it.
+
+## What we need help with
+
+- **Mental health professionals** -- reviewing and refining conversation flows, validating therapeutic content against the Six Cs model
+- **Translators** -- expanding language support (Hebrew, Arabic, English currently; Russian and Amharic are priorities)
+- **Accessibility specialists** -- WCAG 2.2 audit, screen reader testing, assistive technology validation
+- **Developers** -- see [docs/ROADMAP.md](docs/ROADMAP.md) for current priorities
+
+## Code style
+
+- TypeScript throughout -- no `any` unless absolutely necessary
+- Linting: OXLint (Rust-based, runs fast)
+- Formatting: OXFmt
+- UI components: Radix UI + Tailwind CSS
+- No external API calls in the conversation flow -- everything runs offline
+
+## Conversation content
+
+If you're contributing to conversation maps or therapeutic content, coordinate with the team first. Crisis intervention content is reviewed by a mental health professional before merging. Open an issue to discuss before submitting a PR.
+
+## Reporting issues
+
+Use the issue templates:
+- **Bug report** -- something isn't working
+- **Feature request** -- something that should exist
+
+## Code of conduct
+
+Be decent. This project exists to help people in crisis. Bring that same care to how you treat contributors.