Wisemen Core
A collection of packages for Wisemen applications.
Contributing
Making Changes
- Create a PR with your changes
- Add a Bumpy to your PR describing the changes using:
If you have a change that doesn't bump a version, dopnpm bumpy addpnpm bumpy add --emptyFor more details, see the Bumpy documentation documentation - Merge your PR – this triggers the
releaseworkflow - Review the auto-generated PR created by Bumpy, which includes:
- Updated CHANGELOG files
- Bumped version numbers
- Release summary
- Merge the Bumpy release PR to automatically publish all changed packages to npm
New Package Setup
When creating a new package, use fledgling to claim the npm name and configure trusted publishing before the first release:
- Create the package in the workspace – Add the new package under
packages/<group>/<package>and make sure itspackage.jsonhas the correctname. - Claim the name with fledgling – Run fledgling from the repo root so it can discover the new workspace package:
will open an interactive window, which will guide you through claiming the package name and configuring trusted publishing.pnpm fledgling - Keep exclusions in sync – If a public package should not be managed by fledgling, add its name or glob to the
fledgling.ignorelist in the rootpackage.json. - Release through Bumpy – Once the package is claimed and trusted publishing is configured, normal releases continue through the Bumpy workflow.
fledgling reads the workspace manifests defined in package.json and pnpm-workspace.yaml, so the repo only needs to expose the actual workspace packages. In this repo that means docs plus packages/*/*.
Packages
- Address – Address utilities and validation
- API Error – Standardized API error handling
- API Utils – Common API utilities and helpers
- App Container – Application container component
- Auth – Authentication utilities tailored for Zitadel
- Components – A collection of core UI components
- Components Next – The next generation of UI components
- Coordinates – Coordinate utilities
- CSV – CSV parsing and generation
- Date Range – Date range utilities
- Date Time Range – Date-time range utilities
- Datewise – Date-wise data operations
- Decorators – Useful TypeScript decorators
- Design System – Design system components and tokens
- ESLint Config – Shared ESLint configuration
- ESLint Config NestJS – NestJS-specific ESLint configuration
- ESLint Plugin – Custom ESLint rules
- Express DTO Router – DTO validation for Express routers
- Formango – Form management utilities
- Format – Locale-aware string and number formatting utilities.
- Generator – Code generation tools
- Icons – Icon library and utilities
- Int Range – Integer range utilities
- Localized String – Localization string handling
- Modules – Modular application structure
- Monetary – Monetary value utilities
- NestJS Async API – AsyncAPI integration for NestJS
- NestJS File Storage – File storage for NestJS
- NestJS TypeORM – TypeORM integration for NestJS
- Node Doc Processor – Documentation processor for Node
- One Of – Type-safe union utilities
- Open API Plugins – OpenAPI plugin utilities
- OpenTelemetry – OpenTelemetry integration
- Pagination – Pagination utilities
- PGBoss NestJS Job – PGBoss job queue for NestJS
- Planning – Planning and scheduling utilities
- Quantity – Quantity handling utilities
- Telemetry – Telemetry and monitoring utilities
- Template TypeScript – TypeScript package template
- Template Vue – Vue package template
- Time – Time utilities
- Transformer – Data transformation utilities
- Twilio – Twilio integration utilities
- Validators – Validation utilities and schemas
- VIES – VIES VAT validation
- Wise Date – Advanced date utilities
Zod HTTP Client(Deprecated) – A Zod-based HTTP client for Vue applications
License
This project is licensed under the PolyForm Strict License 1.0.0.
Wisemen Core is developed primarily for internal use by the Wisemen agency. We make this codebase freely available for non-commercial purposes, allowing the community to learn from and use our tools at no cost. However, commercial use by other agencies or organizations requires explicit permission.
What this means (in plain English)
- You may freely use the software for any non-commercial purpose
(personal projects, research, education, hobby, non-profit, government, internal evaluation, etc.) - You may not modify, adapt, or create derivative works
- You may not redistribute or share the code (or any modified version)
Commercial use or enterprise licensing?
We offer flexible commercial licenses, support contracts, and custom arrangements for businesses.
Please get in touch at sales@wisemen.digital (or your preferred contact) if you'd like to discuss licensing options.
For more details about what you can and cannot do with this software, please refer to the LICENSE file.
Thank you for respecting the license and supporting years of development on wisemen-core!
Repository Stats
Use the stats script to inspect activity over the last 30 days:
pnpm repo:stats