https://github.com/gregoryandrikopoulos/keyforge
React web application for random password generation.
https://github.com/gregoryandrikopoulos/keyforge
automation ci github-actions mocha password-generator react testing vite vitest webdriverio
Last synced: 3 months ago
JSON representation
React web application for random password generation.
- Host: GitHub
- URL: https://github.com/gregoryandrikopoulos/keyforge
- Owner: gregoryAndrikopoulos
- Created: 2025-08-30T21:00:40.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-09-29T19:20:21.000Z (9 months ago)
- Last Synced: 2025-09-29T21:29:26.779Z (9 months ago)
- Topics: automation, ci, github-actions, mocha, password-generator, react, testing, vite, vitest, webdriverio
- Language: JavaScript
- Homepage:
- Size: 1.01 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Keyforge 🔑
A web application for generating random, secure passwords.
It is built with **React** and powered by **Vite** for fast development
and optimized builds.
---
## Workflow Status
[](https://github.com/gregoryAndrikopoulos/keyforge/actions/workflows/smoke_test.yml)
---
## Tech Stack
- **React 19** — UI
- **Vite 7** — dev server & bundler
- **Vitest 3 + Testing Library** — unit/component tests
- **WebdriverIO 9 (DevTools)** + **Mocha** — Smoke tests
- **ESLint** + **Prettier** — linting & formatting
- **GitHub Actions** — CI for Smoke
- **Node 24**, **pnpm 10** — runtime & package manager
### Runtime Versions
This repo pins tool versions via **asdf** in `.tool-versions`:
```txt
nodejs 24.7.0
pnpm 10.15.1
```
> If you use `asdf`, simply run:
>
> ```bash
> asdf install
> ```
---
## Requirements
- **Node.js** `>=24 <25`
- **pnpm** `>=10 <11`
---
## Getting Started
Install dependencies:
```bash
pnpm install
```
Start the dev server (default: ):
```bash
pnpm dev
```
Build for production:
```bash
pnpm build
```
Preview the production build locally (default: ):
```bash
pnpm preview
```
---
## Testing
### Unit / Component tests (Vitest + Testing Library)
- Location: `src/**/*.test.{js,jsx,ts,tsx}` (co-located with components)
- JSDOM environment with a small setup file at `src/test-utils/setupUnitTests.js`
(adds `@testing-library/jest-dom` matchers and a Web Crypto shim).
Run once in CI mode:
```bash
pnpm test:unit
```
### Smoke tests (WebdriverIO + Mocha)
- Specs live under: `test/specs/`
- Page Objects under: `test/page-objects/`
- Config at: `test/wdio.conf.js`
The WDIO config auto-picks a **baseUrl**:
- `http://localhost:4173` if a `pnpm preview` server is already up, else
- `http://localhost:5173` for the dev server.
You can also override via env:
```bash
WDIO_BASEURL=http://localhost:4173 pnpm test:smoke
```
Typical local flows:
```bash
# 1) Run against the dev server (in another terminal)
pnpm dev
pnpm test:smoke
# 2) Run against a preview server
pnpm build
pnpm preview &
pnpm test:smoke
```