micsapp Speak Local Dev Loop
Overview
Set up a fast, reproducible local development workflow for Speak language learning integrations.
Prerequisites
- Completed
speak-install-authsetup - Node.js 18+ with npm/pnpm
- Code editor with TypeScript support
- Git for version control
- Audio testing tools (optional)
Instructions
- For full implementation details, load:
Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)
Output
- Working development environment with hot reload
- Configured test suite with mocking
- Environment variable management
- Fast iteration cycle for Speak development
- Mock tutor for offline development
Error Handling
| Error | Cause | Solution |
|---|---|---|
| Module not found | Missing dependency | Run npm install |
| Port in use | Another process | Kill process or change port |
| Env not loaded | Missing .env.local | Copy from .env.example |
| Test timeout | Slow network | Use mocks or increase timeout |
| Audio not playing | Browser security | Use HTTPS in dev |
Examples
Debug Mode with Verbose Logging
set -euo pipefail
# Enable verbose logging for Speak operations
DEBUG=speak:* npm run dev
# Log only speech recognition
DEBUG=speak:speech npm run dev
# Log tutor interactions
DEBUG=speak:tutor npm run dev
Development Scripts
{
"scripts": {
"dev": "tsx watch src/index.ts",
"dev:mock": "SPEAK_MOCK_MODE=true tsx watch src/index.ts",
"test:unit": "vitest run tests/unit",
"test:integration": "vitest run tests/integration",
"lesson:spanish": "tsx src/lessons/spanish-basics.ts",
"lesson:korean": "SPEAK_TARGET_LANGUAGE=ko tsx src/lessons/korean-basics.ts"
}
}
Resources
Next Steps
See speak-sdk-patterns for production-ready code patterns.