MoonBite

MoonBite combines solunar tables, moon phase, weather forecast, and barometric pressure into a single daily "fishing score" for your location.

Quick Start

# Install dependencies
npm install

# Start development server
npm start

Open http://localhost:4202 in your browser. The app will automatically reload when you change source files.

Available Commands

Command	Description
npm start	Start dev server at http://localhost:4202
npm run build	Production build (output in dist/)
npm test	Run unit tests (Jasmine/Karma)
npm run test:coverage	Run unit tests and generate coverage report
npm run lint	Run ESLint on TypeScript and HTML files
npm run e2e	Run Playwright end-to-end tests
npm run e2e:ui	Open Playwright UI mode
npm run e2e:report	View the last Playwright HTML report
npm run format	Format source files with Prettier
npm run format:check	Check formatting without writing changes

Project Structure

src/
  app/
    app.component.ts       # Root component
    app.component.html     # Root template
    app.component.scss     # Root styles
    app.component.spec.ts  # Unit tests
    app.config.ts          # Application providers
    app.routes.ts          # Route definitions
  index.html               # App shell
  main.ts                  # Bootstrap entry point
  styles.scss              # Global styles
e2e/
  playwright.config.ts     # Playwright configuration
  tests/
    app.spec.ts            # E2E tests
    app.component.spec.ts  # Component-level tests

Tech Stack

• Angular 21 — Framework
• TypeScript 5.9 — Language
• RxJS 7 — Reactive programming
• Jasmine + Karma — Unit testing
• Playwright — End-to-end testing
• ESLint + angular-eslint — Linting
• Prettier — Code formatting

Development

Adding a New Component

npx ng generate component features/my-feature

Adding a New Service

npx ng generate service core/my-service

Using Claude Agents

This project is set up for Claude Code. The Devcontainer will already have Claude installed and use the built-in agents to accelerate development. If you are developing without the Devcontainer, then you can install it yourself:

# Install Claude Code
curl -fsSL https://claude.ai/install.sh | bash

# Launch in this project
claude

Install the VoltAgent sub-agents for a curated set of specialist agents, then see docs/AGENTS.md for the recommended workflows for this project.

Running Tests with Coverage

After running npm run test:coverage, open coverage/moonbite/index.html to view the full coverage report. The project enforces a minimum 85% coverage threshold.

Contributing

1. Create a feature branch from main
2. Make your changes
3. Ensure tests pass: npm test
4. Ensure linting passes: npm run lint
5. Format code: npm run format
6. Submit a pull request