Elnatan Samuel

Sirou Define routes once. Navigate everywhere. Sirou is a universal type safe routing engine for the modern JS/TS ecosystem. Write your route schema once, get compile time safety, async route guards, data loaders, deep link generation, and a built in DevTools panel all working identically across React, Next.js, Svelte, and React Native. Why Sirou? Problem Sirou Solution Typos in route names crash at runtime TypeScript catches them at compile time Route params are untyped Full param type inference & validation per route Different navigation APIs on every platform One call works everywhere No way to protect routes without boilerplate Async composable guards register once, run everywhere Data fetching is totally separate from routing Integrated Data Loaders pre fetch before render No visibility into navigation state Built in DevTools panel with history, params, and meta Packages Package Version Description Core engine, Radix Trie matcher, type system, guards React adapter, hooks, DevTools, Data Loaders Next.js App Router + Middleware adapter SvelteKit adapter with reactive stores React Navigation v6+ integration Installation Quick Start 1 Define your routes /api/products/${params.productId} 2 Set up the provider 3 Navigate with full type safety Route Guards Guards are async functions that run before navigation. They can allow, block, or redirect. Guards are attached to routes by name and registered on the provider: Guard on Initial Load When the app first loads, Sirou checks guards on the initial route too not just on navigation. This prevents users from deep linking directly to protected pages. Next.js Middleware Guard For server side protection (SSR / RSC), use : Data Loaders Attach a to any route. The data is pre fetched before the route renders and accessible via . /api/products/${params.productId} Features at a Glance Feature API Type safe navigation Type safe URL builder Route param validation in config Route guards + Initial route protection called automatically on mount Data loaders in config Route history Wildcard / 404 routes Deep link generation (React Native) Analytics tracking Auto document title Breadcrumb generation DevTools panel Schema validation React Native Deep Links Sirou automatically generates a React Navigation linking config from your route schema: DevTools Add anywhere in your React app. A floating button appears in the bottom right corner. Click it to open a panel showing the current route, navigation history, params, and metadata in real time. Schema Validation Validate your route config at startup to catch mistakes early: Catches: duplicate paths, params defined but missing from path, and path params without a matching config. Troubleshooting Guards not firing? Always navigate via or . Sirou cannot intercept native clicks (except in Svelte via ). Make sure guards are registered before the first render (pass them to the provider's prop). Initial route not guarded? is called automatically by the React / React Native providers. For Svelte / custom setups, call manually after attaching guards. Redirect loop in Svelte? Make sure you're using it uses the flag to prevent from re running after Sirou calls . Documentation Full docs are available at sirou.vercel.app and in the folder of this repository. Contributing Contributions are welcome! Please read CONTRIBUTING.md and open a pull request. Community Website: sirou.vercel.app Contact: elnatansamuel25@gmail.com Issues: GitHub Issues License MIT © Sirou Contributors

@elnatansamuel25

0

27

Venvy Strict environment variable governance for modern applications Venvy is a professional commandline tool and library designed for strict environment variable governance in Node.js, React, Next.js, and React Native applications. It ensures that your applications always run with a valid, typesafe, and complete set of environment variables. Why Venvy? Stop letting environment variables cause runtime errors and configuration nightmares. Venvy brings enterprisegrade environment governance to your projects with zero configuration overhead. Core Purpose Strict Validation: Enforce that all required environment variables are present and match defined types at application startup or during CI/CD Type Safety: Automatically infer TypeScript types from your environment schema, ensuring that access is safe and predictable CrossEnvironment Consistency: Detect missing or extra variables across different environment files (e.g., .env.development vs. .env.production) Simplified Onboarding: Generate .env.example files automatically to help new developers set up their local environments quickly CI/CD Integration: Exit with nonzero codes when validation fails, allowing you to catch configuration errors before they reach production Features SchemaBased Definition: Define your environment structure using a fluent API that supports strings, numbers, booleans, enums, and URLs Advanced Validators: Builtin support for , , , and custom validation Conditional Validation: Use to make variables required only under specific conditions Automatic Documentation: Generate and inject environment variable tables directly into your README.md Git Hooks: Automatically set up precommit hooks to prevent invalid configurations from being committed JIT Schema Loading: Load schema files directly in the CLI without a manual compilation step Project Scaffolding: Use to automatically generate a schema from your existing files Interactive Sync: Use to interactively fill in missing variables in your Zod Integration: Power Venvy with your existing Zod schemas using the bridge Installation Quick Start 1. Define Your Schema Create a file named (or ) in your project root: Using Zod If you already use Zod, you can bridge your schema seamlessly: 2. CLI Commands Venvy provides a powerful CLI for management and automation. Initialize Venvy in an existing project: Interactively sync missing variables: Validate the current environment: Compare environments: Inject documentation table into README: Generate .env.example: Set up Git precommit hook: 3. Runtime Protection To protect your application at runtime, call at the very beginning of your entry point: Advanced Usage Conditional Requirements Make variables required only in specific scenarios: Custom Validation Add your own validation logic: Environment Comparison Ensure consistency across your environments: Technical Architecture Venvy is designed to be lightweight with minimal dependencies. It leverages TypeScript's advanced type inference to provide a seamless developer experience without requiring manual type maintenance or complex code generation. Key Design Principles Zero Runtime Overhead: Validation happens once at startup Type Safety First: All environment access is fully typed Developer Experience: Intuitive CLI with helpful error messages CI/CD Ready: Built for automated workflows API Reference Core Validators Validator Description Example String values Numeric values Boolean values URL validation Email validation Port numbers Enum values Advanced Methods Mark as required Set default value Add description for docs Conditional requirement Custom regex validation Numeric/string constraints Community & Support Full Documentation Comprehensive guides and API reference Issue Tracker Report bugs and request features Discussions Community discussions and Q&A Contributing We welcome contributions! Please see our Contributing Guide for details. Development Setup License MIT © Elnatan Samuel Star this repo if Venvy helped you! Made with ❤️ by Elnatan Samuel Environment Variables Variable Type Required Default Description DBURL url Yes Main PostgreSQL connection string PORT port No Application server port NODEENV enum Yes ADMINEMAIL email Conditional System administrator email for alerts JWTSECRET string Yes Secret key for signing JSON Web Tokens

@elnatansamuel25

0

37