Attack First Shared

Shared types, constants, utilities, and theme for Attack First clients.

Overview

This package is consumed by:

• attack-first-web
• attack-first-mobile

It ensures consistency across platforms for:

• TypeScript types & interfaces
• Constants & configuration
• Utility functions
• Theme definitions

Structure

src/
├── config/       # Shared configuration
├── constants/    # App-wide constants
├── services/     # Shared service logic
├── theme/        # Design system tokens
├── types/        # TypeScript interfaces
└── utils/        # Utility functions

Local Development Startup Order

This package has no server, but when developing locally against the full ecosystem:

| Step | Repo | Command | Port | |------|------|---------|------| | 1 | attack-first-api | npm run dev | 4000 | | 2 | attack-first-web | npm run dev | 3005 | | 3 | attack-first-mobile | npm start → i for iOS | 8081 (Metro) |

Always start the API first — web and mobile depend on it for auth and data.

Usage

As NPM Package (Recommended)

npm install attack-first-shared

import { GameStatus, TIER_LIMITS } from 'attack-first-shared';

As Local Package (Development)

{
  "dependencies": {
    "@attack-first/shared": "file:../attack-first-shared"
  }
}

Publishing

# Bump version
npm version patch|minor|major

# Publish to npm (private)
npm publish

Related Repos

| Repo | Purpose | |------|---------| | attack-first-api | Backend API | | attack-first-web | Web app (consumes this) | | attack-first-mobile | Mobile app (consumes this) | | docs | BRDs and documentation |