{"id":15136720,"url":"https://github.com/FawazKatranji/banking-app","last_synced_at":"2025-10-23T11:31:47.299Z","repository":{"id":251561177,"uuid":"837752716","full_name":"LightningFz/banking-app","owner":"LightningFz","description":"Surge is a modern banking platform for everyone","archived":false,"fork":false,"pushed_at":"2024-10-01T03:35:19.000Z","size":1174,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-30T18:06:30.384Z","etag":null,"topics":["appwrite","banking","chartjs","fintech","nextjs","plaid","typescript"],"latest_commit_sha":null,"homepage":"","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/LightningFz.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}},"created_at":"2024-08-03T23:24:23.000Z","updated_at":"2024-10-01T03:35:22.000Z","dependencies_parsed_at":"2024-09-18T03:23:57.258Z","dependency_job_id":"95711b3f-61f3-448d-a6d4-d947238a2071","html_url":"https://github.com/LightningFz/banking-app","commit_stats":{"total_commits":35,"total_committers":2,"mean_commits":17.5,"dds":0.05714285714285716,"last_synced_commit":"2c816e8ca83e57982a0ea7c707378666b4c4b9a8"},"previous_names":["lightningfz/banking-app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LightningFz%2Fbanking-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LightningFz%2Fbanking-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LightningFz%2Fbanking-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LightningFz%2Fbanking-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LightningFz","download_url":"https://codeload.github.com/LightningFz/banking-app/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237821623,"owners_count":19371796,"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","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":["appwrite","banking","chartjs","fintech","nextjs","plaid","typescript"],"created_at":"2024-09-26T06:40:49.555Z","updated_at":"2025-10-23T11:31:41.811Z","avatar_url":"https://github.com/LightningFz.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"Here's how you can narrate this for your README as if you built \"Surge,\" based on the template you provided:\n\n---\n\n# Surge\n\nSurge is a powerful financial SaaS platform built using **Next.js**, designed to give users full control over their finances by connecting to multiple bank accounts. It allows users to view transactions in real-time, manage their finances, and transfer money securely to other platform users. Surge combines cutting-edge technology with a seamless user experience to help users manage their financial life effortlessly.\n\n## ⚙️ Tech Stack\n\n- **Next.js**: Core framework for building the front-end and back-end of the platform.\n- **TypeScript**: Provides strong type definitions to improve code reliability.\n- **Appwrite**: Back-end server handling authentication, user management, and database.\n- **Plaid**: Enables seamless bank integration and real-time transaction tracking.\n- **Dwolla**: Powers secure fund transfers between platform users.\n- **React Hook Form**: Simplifies form management and validation.\n- **Zod**: Schema validation library used for ensuring data integrity.\n- **TailwindCSS**: Utility-first CSS framework for designing responsive layouts.\n- **Chart.js**: Utilized for visualizing financial data through dynamic charts.\n- **ShadCN**: Provides a comprehensive component library for styling and UI elements.\n\n## 🔋 Features\n\n- **Authentication**: Implements ultra-secure SSR authentication with robust validation and authorization mechanisms.\n- **Connect Banks**: Links to multiple bank accounts through Plaid for real-time transaction data and balance updates.\n- **Home Page Overview**: Displays a total account balance from all connected banks, recent transactions, categorized spending, and more.\n- **My Banks**: Lists all connected banks with individual account details and balances.\n- **Transaction History**: Users can view detailed transaction history with pagination and filtering options for specific accounts or date ranges.\n- **Real-time Updates**: Reflects changes across all relevant pages when new accounts are linked, ensuring up-to-date information across the platform.\n- **Funds Transfer**: Facilitates user-to-user fund transfers using Dwolla, with secure input fields for recipient bank details.\n- **Responsiveness**: Ensures a smooth experience across desktop, tablet, and mobile, adjusting the layout for different screen sizes.\n\n## 🤸 Quick Start\n\n### Prerequisites\n\nBefore starting, ensure you have the following installed:\n\n- Git\n- Node.js\n- npm (Node Package Manager)\n\n### Cloning the Repository\n\n```bash\ngit clone https://github.com/your-username/surge.git\ncd surge\n```\n\n### Installation\n\nInstall the project dependencies:\n\n```bash\nnpm install\n```\n\n### Set Up Environment Variables\n\nCreate a `.env` file in the root directory and add the following content:\n\n```bash\n#NEXT\nNEXT_PUBLIC_SITE_URL=\n\n#APPWRITE\nNEXT_PUBLIC_APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1\nNEXT_PUBLIC_APPWRITE_PROJECT=\nAPPWRITE_DATABASE_ID=\nAPPWRITE_USER_COLLECTION_ID=\nAPPWRITE_BANK_COLLECTION_ID=\nAPPWRITE_TRANSACTION_COLLECTION_ID=\nAPPWRITE_SECRET=\n\n#PLAID\nPLAID_CLIENT_ID=\nPLAID_SECRET=\nPLAID_ENV=\nPLAID_PRODUCTS=\nPLAID_COUNTRY_CODES=\n\n#DWOLLA\nDWOLLA_KEY=\nDWOLLA_SECRET=\nDWOLLA_BASE_URL=https://api-sandbox.dwolla.com\nDWOLLA_ENV=sandbox\n```\n\nMake sure to replace the placeholder values with your actual credentials, which can be obtained by signing up on Appwrite, Plaid, and Dwolla.\n\n### Running the Project\n\nTo start the development server, run:\n\n```bash\nnpm run dev\n```\n\nThen open [http://localhost:3000](http://localhost:3000) in your browser to access the platform.\n\n---\n\nThis setup showcases the key aspects of the app and provides detailed instructions for installation and running the project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFawazKatranji%2Fbanking-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FFawazKatranji%2Fbanking-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFawazKatranji%2Fbanking-app/lists"}