RSS Reader Monorepo Development

This skill provides comprehensive guidance for developing a modern RSS reader application built as a TypeScript monorepo with web, native mobile, and API applications.

Project Architecture

You are working with a Turborepo monorepo containing:

Core Development Principles

1. **Language**: Always respond in Japanese (必ず日本語で回答)

2. **Attitude**: Be an enthusiastic developer who tackles any challenge, pushes limits, and strives for excellence

3. **Documentation**: Apply necessary changes to docs/ directory on every iteration

4. **Testing**: Build and test apps/packages after changes to ensure all applications work correctly

5. **Sound Notifications**: Play a sound when user confirmation or input is needed:

```bash

afplay /System/Library/Sounds/Bottle.aiff

```

Design & UI Guidelines

Development Workflow

Initial Setup

Each application requires individual `npm install` (workspace feature not supported):

```bash

cd apps/api && npm install

cd apps/web && npm install

cd apps/native && npm install

cd packages/sdk && npm install

```

Root-Level Commands

Use these for most development tasks:

```bash

npm run dev # Start all apps in parallel (API, Web, Native)

npm run build # Build all applications

npm run test # Run tests across all apps

npm run lint # Lint with Biome

npm run type-check # Type check all applications

npm run format # Format code with Biome

npm run clean # Clean build artifacts

```

Individual App Development

```bash

API server (port 3001)

cd apps/api && npm run dev

Web app (port 3000, auto-selects alternate if busy)

cd apps/web && npm run dev

Native app (port 8081)

cd apps/native && npm run dev

SDK development

cd packages/sdk && npm run dev

```

Database Operations

```bash

cd apps/api

npx prisma generate # Generate Prisma client

npx prisma migrate dev # Run database migrations

npx prisma db push # Push schema changes

npx prisma studio # Open Prisma Studio

Test database

npx prisma generate --schema=prisma/schema.test.prisma

npx prisma db push --schema=prisma/schema.test.prisma

```

Testing

```bash

npm run test # All tests

npm run test:coverage # With coverage

cd apps/api && npm run test # API tests only

cd apps/web && npm run test # Web tests only

```

Code Standards

Environment Configuration

Create `apps/api/.env`:

```env

DATABASE_URL="postgresql://user:password@localhost:5432/rss_reader"

JWT_SECRET="your-super-secret-jwt-key-change-this-in-production"

PORT=3001

NODE_ENV="development"

WEB_URL="http://localhost:3000"

ALLOWED_ORIGINS="http://localhost:3000,http://localhost:19006"

```

Key Features

Authentication API Endpoints

All endpoints include validation, error handling, and security:

Deployment

Working with This Project

When making changes:

1. Ensure all dependencies are installed in each app directory

2. Run builds and tests after modifications

3. Update documentation in docs/ directory

4. Verify changes work across web and native apps

5. Follow platform-specific guidelines for optimal UX

6. Maintain code standards (Biome, Zod validation, TypeScript strict mode)

7. Play sound notification when user input needed

Reference the following documentation files for detailed specifications: