social-security-tools

Website Source for https://ssa.tools/.

The code here builds what is statically served at that site.

Development Setup

This project requires Node.js 22.19.0+ or 20.19+. We recommend using NVM to manage Node.js versions.

Quick Setup

# Clone the repository
git clone https://github.com/Gregable/social-security-tools.git
cd social-security-tools

# Run the setup script (installs Node.js, dependencies, and runs quality checks)
npm run setup

Manual Setup

1. Install Node.js (if not using the setup script):

   # Using NVM (recommended)
   nvm install
   nvm use
   
   # Or install Node.js 22.19.0+ manually

2. Install dependencies:

   npm install --legacy-peer-deps

3. Start development server:

   npm run dev

Available Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm run test - Run unit tests
• npm run quality - Run formatting, linting, and type checking
• npm run storybook - Start Storybook for component development

Docker

The website can be run locally as a Docker container. Run the latest image from Docker Hub:

docker run -p 4173:4173 gregable/ssa-tools:latest

Then load https://localhost:4173/ in your browser.

Star History