Raiymbek Park

An app for residents of Raiymbek Park — announcements, maintenance requests, and a fast line to the people who can help when something breaks.

About

An online space for the residents and owners of the Raiymbek Park apartment complex. It is home to the digital services that make day-to-day life in the building easier and the way it is run clearer and more transparent.

Services:

• News and announcements for the complex — scheduled utility work and other events worth knowing about.
• Polls, meetings, and decisions residents make together.
• Requests to fix faults and report violations.
• Status and history of every request.
• A direct line to the on-duty maintenance staff.
• A building-wide chat.

Layout

.
├── apps/
│   ├── web/        React SPA — FSD layers, TanStack Router, tRPC + TanStack Query
│   └── api/        tRPC server
├── packages/
│   ├── ui/         Design-system primitives
│   └── shared/     Framework-agnostic helpers
└── design/         .pen sources and image assets

Getting started

# Node 20+ recommended
npm install

# copy and adjust the web env (tRPC endpoint, optional base path)
cp apps/web/.env.example apps/web/.env

# run web + api together (Turborepo)
npm run dev

The web app comes up on http://localhost:5173, the tRPC stub server on http://localhost:3001.

Conventions

• Feature-Sliced Design — the app / pages / features / shared layers (enforced by the Steiger linter: npm run lint:fsd in apps/web).
• Files in kebab-case, components in PascalCase, named exports.
• Styles through CSS modules and design tokens (apps/web/src/app/tokens.scss).
• Tests live next to the implementation; e2e sits in apps/web/src/test.

The full rules (code, HTML semantics, styling, state management) are in .claude/rules/.