{"id":31893721,"url":"https://github.com/tripkode-admin/creditoya-superapp","last_synced_at":"2025-10-13T09:07:50.703Z","repository":{"id":291220077,"uuid":"976973281","full_name":"TripKode-admin/creditoya-superapp","owner":"TripKode-admin","description":null,"archived":false,"fork":false,"pushed_at":"2025-09-09T20:27:47.000Z","size":3878,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-09T23:31:59.688Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://creditoya.space","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TripKode-admin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-03T06:06:38.000Z","updated_at":"2025-09-09T20:27:50.000Z","dependencies_parsed_at":"2025-05-07T16:43:59.986Z","dependency_job_id":"6f2409e4-1021-4893-b3d8-56a05adb03ad","html_url":"https://github.com/TripKode-admin/creditoya-superapp","commit_stats":null,"previous_names":["tripcodeteam/creditoya-superapp","tripkode/creditoya-superapp","tripkode-admin/creditoya-superapp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/TripKode-admin/creditoya-superapp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TripKode-admin%2Fcreditoya-superapp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TripKode-admin%2Fcreditoya-superapp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TripKode-admin%2Fcreditoya-superapp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TripKode-admin%2Fcreditoya-superapp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TripKode-admin","download_url":"https://codeload.github.com/TripKode-admin/creditoya-superapp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TripKode-admin%2Fcreditoya-superapp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279014482,"owners_count":26085535,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-13T09:07:48.726Z","updated_at":"2025-10-13T09:07:50.694Z","avatar_url":"https://github.com/TripKode-admin.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CreditoYa Web Application (v2)\n\n\u003e **Estado del proyecto:** 🟢 Producción\n\nThis repository contains the source code for the CreditoYa web application (v2), a platform built with Next.js and TypeScript. It's designed to be a progressive web app (PWA) and can also be bundled as a native mobile application using Capacitor.\n\n## Project Overview\n\nCreditoYa is a financial services platform. This codebase represents its second version, focusing on providing a modern, responsive user experience for accessing these services.\n\n## Tech Stack\n\n*   **Framework:** [Next.js](https://nextjs.org/) (v15.3.0)\n*   **Language:** [TypeScript](https://www.typescriptlang.org/)\n*   **UI:**\n    *   [React](https://reactjs.org/) (v19)\n    *   [Tailwind CSS](https://tailwindcss.com/) (v4)\n    *   [Lucide React](https://lucide.dev/guide/packages/lucide-react) (for icons)\n*   **API Communication:** [Axios](https://axios-http.com/)\n*   **Mobile Bundling:** [Capacitor](https://capacitorjs.com/) (for Android and iOS)\n*   **Key Libraries:**\n    *   `@vercel/speed-insights`: Performance monitoring.\n    *   `driver.js`: For guided tours and feature introductions.\n    *   `js-cookie`: Client-side cookie management.\n    *   `jwt-decode`: Decoding JSON Web Tokens.\n    *   `pako`: zlib compression/decompression.\n    *   `react-select`: Enhanced select input components.\n    *   `react-signature-canvas`: For capturing user signatures.\n    *   `sonner`: Toast notifications.\n*   **Linting:** [ESLint](https://eslint.org/)\n*   **Package Manager:** npm (inferred from `package-lock.json`)\n\n## Project Structure\n\n*   `src/app/`: Main application code, following Next.js App Router conventions.\n    *   `api/`: Backend API route handlers.\n    *   `auth/`: Authentication related pages and components.\n    *   `panel/`: User dashboard/panel sections.\n*   `src/components/`: Reusable React components.\n*   `src/context/`: React Context providers (e.g., `AuthContext`, `DarkModeContext`).\n*   `src/hooks/`: Custom React hooks.\n*   `src/lib/`: Utility functions and libraries (e.g., `api-client.ts`).\n*   `public/`: Static assets.\n*   `android/`, `ios/`: Capacitor native project folders (generated).\n*   `mobile-dist/`: Output directory for mobile builds (used by Capacitor).\n\n## Getting Started\n\n### Prerequisites\n\n*   Node.js (check `package.json` for engine specifics, or use a recent LTS version)\n*   npm\n\n### Installation\n\n1.  Clone the repository:\n    ```bash\n    git clone \u003crepository-url\u003e\n    cd creditoya_web_v2\n    ```\n2.  Install dependencies:\n    ```bash\n    npm install\n    ```\n\n### Running the Development Server\n\nTo run the web application in development mode (with Turbopack):\n\n```bash\nnpm run dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) in your browser to see the result. The page auto-updates as you edit files.\n\n### Building for Production\n\n**Web Application:**\n\nTo create a production build for the web:\n\n```bash\nnpm run build\n```\n\nThis will generate an optimized build in the `.next` directory. To run this build locally:\n\n```bash\nnpm run start\n```\n\n**Mobile Application (Capacitor):**\n\n1.  Build the web assets specifically for mobile (outputs to `mobile-dist/`):\n    ```bash\n    npm run build:mobile\n    ```\n    *(Note: This script uses `next.config.mobile.js`, which might contain specific configurations for the mobile build.)*\n\n2.  Sync the web assets with the native Capacitor projects:\n    ```bash\n    npx cap sync\n    ```\n\n3.  Open the native project in its IDE:\n    *   For Android:\n        ```bash\n        npx cap open android\n        ```\n    *   For iOS:\n        ```bash\n        npx cap open ios\n        ```\n    Then, build and run from Android Studio or Xcode.\n\n## Scripts\n\nKey scripts available in `package.json`:\n\n*   `npm run dev`: Starts the Next.js development server with Turbopack.\n*   `npm run build`: Creates a production build of the Next.js web application.\n*   `npm run build:mobile`: Creates a production build specifically for Capacitor (outputs to `mobile-dist/`).\n*   `npm run start`: Starts the Next.js production server after a build.\n*   `npm run lint`: Lints the codebase using ESLint.\n*   `npm run cap:sync`: Convenience script that runs `build:mobile` then `npx cap sync`.\n*   `npm run cap:android`: Runs `cap:sync` then opens the Android project.\n*   `npm run cap:ios`: Runs `cap:sync` then opens the iOS project.\n\n## Linting\n\nThis project uses ESLint for code quality. Run the linter with:\n\n```bash\nnpm run lint\n```\n\nEnsure there are no linting errors before committing changes.\n\n## Configuration Files\n\n*   `next.config.ts`: Main Next.js configuration.\n*   `next.config.mobile.js`: (Assumed) Next.js configuration for mobile builds.\n*   `capacitor.config.ts`: Capacitor configuration, including app ID and server settings.\n*   `tsconfig.json`: TypeScript compiler options.\n*   `postcss.config.mjs`, `tailwind.config.js` (Implicit, based on `tailwindcss` dependency): Configuration for Tailwind CSS.\n*   `eslint.config.mjs`: ESLint configuration.\n\n## Deployment\n\n*   **Web:** The `next.config.ts` specifies `output: 'standalone'`, suggesting deployments as a standalone Node.js server. The original README also mentioned Vercel.\n*   **Mobile Backend/API:** The `capacitor.config.ts` points to a server URL at `https://creditoya-superapp-beta-894489564991.us-central1.run.app`, likely a Google Cloud Run deployment for backend services used by the mobile app.\n\n## Further Learning (Next.js)\n\n*   [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.\n*   [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.\n\n---\n\n*This README provides a technical overview for developers. For user-facing information about CreditoYa, please refer to the application's official website or contact the CreditoYa team.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftripkode-admin%2Fcreditoya-superapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftripkode-admin%2Fcreditoya-superapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftripkode-admin%2Fcreditoya-superapp/lists"}