1313### Prerequisites
1414
1515- ** Node.js** >= 20
16- - ** pnpm ** >= 9
16+ - ** npm ** >= 10 (bundled with Node.js)
1717- ** Docker** & Docker Compose
1818- ** React Native** dev environment — follow the [ official setup guide] ( https://reactnative.dev/docs/environment-setup )
1919
@@ -25,7 +25,11 @@ git clone https://github.com/Dev-Card/DevCard.git
2525cd devcard
2626
2727# 2. Install dependencies
28- pnpm install
28+ npm install # root (orchestrator)
29+ npm --prefix packages/shared install # shared types/utils
30+ npm --prefix apps/backend install # backend API
31+ npm --prefix apps/web install # web app
32+ npm --prefix apps/mobile install # mobile app (if working on mobile)
2933
3034# 3. Start PostgreSQL + Redis
3135docker compose up -d
@@ -35,34 +39,34 @@ cp .env.example .env
3539# Edit .env with your OAuth credentials
3640
3741# 5. Run database migrations and seed
38- pnpm db:migrate
39- pnpm db:seed
42+ npm run db:migrate
43+ npm run db:seed
4044
4145# 6. Start development
42- pnpm dev:backend # Backend API on :3000
43- pnpm dev:mobile # React Native app
46+ npm run dev:backend # Backend API on :3000
47+ npm run dev:mobile # React Native app
4448```
4549
4650### Running Tests
4751
48- This project uses ` pnpm ` to run tests across different parts of the codebase.
52+ This project uses ` npm ` to run tests across different parts of the codebase.
4953
5054#### Run all tests
51- To execute all available tests:
55+ To execute backend tests:
5256``` bash
53- pnpm -r test
57+ npm run test
5458```
5559
5660#### apps/backend
5761The backend uses Vitest:
5862``` bash
59- pnpm --filter @devcard /backend test
60- pnpm --filter @devcard /backend test:watch
63+ npm --prefix apps /backend run test
64+ npm --prefix apps /backend run test:watch
6165```
6266#### apps/mobile
6367The mobile app uses Jest:
6468``` bash
65- pnpm --filter @devcard /mobile test
69+ npm --prefix apps /mobile run test
6670```
6771#### apps/web
6872Currently, the web app does not define a test script.
@@ -84,16 +88,16 @@ devcard/
8488## Coding Standards
8589
8690- ** TypeScript** for all new code
87- - ** ESLint + Prettier** for formatting (run ` pnpm lint` before committing)
91+ - ** ESLint + Prettier** for formatting (run ` npm run lint` before committing)
8892- ** Conventional Commits** for commit messages (` feat: ` , ` fix: ` , ` docs: ` , ` chore: ` )
8993- Write tests for new features and bug fixes
9094
9195## Pull Request Process
9296
93971 . Create a feature branch from ` main ` : ` git checkout -b feat/your-feature `
94982 . Make your changes with clear, descriptive commits
95- 3 . Ensure all tests pass: ` pnpm test`
96- 4 . Ensure linting passes: ` pnpm lint`
99+ 3 . Ensure all tests pass: ` npm run test`
100+ 4 . Ensure linting passes: ` npm run lint`
971015 . Open a PR against ` main ` with a clear description of the change
981026 . Wait for review — maintainers will respond within 48 hours
99103
0 commit comments