en un clic
development
// Development conventions and tooling for the telegramable monorepo. Use when working on code, dependencies, or builds.
// Development conventions and tooling for the telegramable monorepo. Use when working on code, dependencies, or builds.
| name | development |
| description | Development conventions and tooling for the telegramable monorepo. Use when working on code, dependencies, or builds. |
| compatibility | Requires pnpm >=9.0 and Node.js >=22 |
| metadata | {"author":"telegramable","version":"0.1.0"} |
Standards and conventions for developing in the telegramable pnpm monorepo.
Activate this skill when:
telegramable/
├── apps/ # Deployable applications
│ └── web/ # @telegramable/web - Next.js frontend
├── packages/ # Shared libraries
│ └── ui/ # @telegramable/ui - UI components
├── src/ # Root package source (core runtime)
├── specs/ # LeanSpec specifications
└── tests/ # E2E and integration tests
All workspace packages use the @telegramable/ scope:
@telegramable/web - Web application@telegramable/ui - UI component library| Tool | Version | Purpose |
|---|---|---|
| Node.js | >=22 | Runtime |
| pnpm | >=9.15 | Package manager |
| TypeScript | ^5.x | Type checking |
# Install all dependencies
pnpm install
# Run root package in dev mode
pnpm dev
# Build root package
pnpm build
# Run E2E tests
pnpm test:e2e
# Run command in specific package
pnpm --filter @telegramable/web dev
pnpm --filter @telegramable/ui build
# Run command in all packages
pnpm -r build
# Add dependency to specific package
pnpm --filter @telegramable/web add <package>
# Add shared dependency to workspace root
pnpm add -w <package>
# Add dev dependency
pnpm add -D <package>
pnpm --filter @telegramable/web add -D <package>
workspace:* protocol for internal packagesTo use @telegramable/ui in @telegramable/web:
pnpm --filter @telegramable/web add @telegramable/ui
This creates a workspace:* reference in package.json.
mkdir apps/new-app
cd apps/new-app
pnpm init
Update package.json:
{
"name": "@telegramable/new-app",
"private": true
}
mkdir packages/new-lib
cd packages/new-lib
pnpm init
Update package.json:
{
"name": "@telegramable/new-lib"
}
After creating, run pnpm install from root to link the new package.
--filterpnpm ls -r to see workspace structurepnpm install --frozen-lockfile in CIThe GitHub Actions workflow uses:
--frozen-lockfile for reproducible buildsSee .github/workflows/copilot-setup-steps.yml for the setup configuration.
Access Railway deployments, logs, and environment variables. Use when asked to check deployment status, view service logs, inspect or update environment variables, redeploy a service, or diagnose production issues on Railway.
Spec-Driven Development methodology for AI-assisted development. Use when working in a LeanSpec project.