Back to list
polarsource

local-environment

by polarsource

Turn your software into a business.

9,305🍴 646📅 Jan 23, 2026

Use Cases

Efficient Code Generation

Auto-generate boilerplate code to reduce development time.

🔍

Code Review Assistance

Analyze PR changes and suggest improvements.

🔧

Refactoring Suggestions

Suggest refactoring options to improve code quality.

SKILL.md


name: local-environment description: Local development environment management for Polar using Docker license: MIT metadata: author: polar version: "1.0.0"

Local Environment Skill

This skill enables Claude to help manage the Polar local development environment using Docker. Use this when the user needs to start, stop, debug, or understand the local development stack.

Conductor Integration

CRITICAL: When running in Conductor, always check CONDUCTOR_PORT first to determine the instance number:

echo $CONDUCTOR_PORT
  • If CONDUCTOR_PORT is not set → Not running in Conductor, use instance 0
  • If CONDUCTOR_PORT is set → Calculate instance: INSTANCE=$((CONDUCTOR_PORT - 55090))
CONDUCTOR_PORTInstance
550900
550911
550922
550933

Always use -i $INSTANCE flag with all docker-dev commands when running in Conductor.

When to Use

  • User asks to start/stop the local environment
  • User needs to view logs or debug issues
  • User wants to run multiple isolated instances
  • User needs to understand the service architecture
  • User encounters container or service errors

Quick Reference

TaskCommand
Start full stack./dev/docker-dev -i $INSTANCE -d
Stop services./dev/docker-dev -i $INSTANCE down
View all logs./dev/docker-dev -i $INSTANCE logs
View service logs./dev/docker-dev -i $INSTANCE logs {service}
Follow logs./dev/docker-dev -i $INSTANCE logs -f
Check status./dev/docker-dev -i $INSTANCE ps
Restart service./dev/docker-dev -i $INSTANCE restart {service}
Shell access./dev/docker-dev -i $INSTANCE shell {service}
Fresh start./dev/docker-dev -i $INSTANCE cleanup && ./dev/docker-dev -i $INSTANCE -d
With monitoring./dev/docker-dev -i $INSTANCE --monitoring -d
Force rebuild./dev/docker-dev -i $INSTANCE -b -d

Services

ServiceDefault PortDescription
api8000FastAPI backend
worker-Background job processor
web3000Next.js frontend
db5432PostgreSQL database
redis6379Redis cache
minio9000/9001S3-compatible storage
prometheus9090Metrics (optional)
grafana3001Dashboards (optional)

Instance Port Mapping

Port = Base Port + (Instance × 100)

InstanceAPIWebDBRedisMinIO
080003000543263799000
181003100553264799100
282003200563265799200

Rules Index

RuleCategoryDescription
service-architectureReferenceService details

Score

Total Score

80/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 1000以上

+15
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

+5
Issue管理

オープンIssueが50未満

0/5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon