Impenetrable Connect is a service reservation platform designed for local residents and entrepreneurs within conservation projects, starting with the IMPE (Impenetrable Chaco) region.
The platform's main goal is to manage requests for activities and gastronomic services using a fair and equitable rotation logic. It replaces manual assignment with an automated cascading routing engine, ensuring zero friction for tourists while transparently allocating orders to local ventures.
- Tourist Access (Zero Friction): Tourists request activities or services via a mobile application without cumbersome passwords. Access is granted instantly via aliases and browser fingerprints.
- Entrepreneur Dashboard: Local hosts manage their assigned ventures, pause items if they run out of stock (Individual Pause), close the venue for the day (General Pause), and track their daily agenda.
- Automated Cascade Engine: A strict routing algorithm iterates through ventures by order, evaluating capacities, schedules, and pauses. It supports timeouts and automatic re-assignment guarantees.
- Unified Identity Model: Both Tourists and Entrepreneurs map to a unified database structure with strict data projections for maximum frontend type safety.
The project leverages a high-performance modern stack built around a Bun Monorepo, utilizing a "Frontend-First with Mocks" deployment strategy to validate UX iteratively.
- Runtime & Tooling: Bun (Workspaces)
- Mobile / UI: React Native via Expo, styled exclusively with NativeWind & Tailwind CSS.
- State Management: Zustand (powers the offline UX iteration mocks inside the client).
- Shared Contracts:
Zodacts as the definitive Single Source of Truth inside@repo/sharedfor seamless End-to-End type safety. - Backend Engine: Hono (API Framework) + Drizzle ORM.
- Database: PostgreSQL (with
JSONBpowering native i18n capabilities).
Built and orchestrated using a Spec-Driven Development (SDD) workflow.
/openspec/specs/: Central repository definitions. Review01-master-system.mdfor unabridged business rules, ERD, and UI mock requirements./packages/shared/: Data contracts, enumerators, and Zod schemas shared across the ecosystem./apps/mobile/: The React Native/Expo frontend interface./apps/backend/: The autonomous routing engine and backend API.
- Ensure Bun is installed globally.
- Clone the repository and install all dependencies:
bun install
- To understand the implementation roadmaps and business domain, read:
openspec/specs/01-master-system.md - Spin up the development server:
bun run dev
The Impenetrable Connect application is deployed to the web using Expo's EAS Hosting service.
Live URL: https://impenetrable-connect.expo.app/
Web builds and deployments are automatically triggered on pushes to the main branch via GitHub Actions workflow (.eas/workflows/deploy-web.yml).
See the Web Publishing Specification for detailed technical information.