PochiYangu

PochiYangu (pochi) is a modern web application built with Next.js, React, and Tailwind CSS. This repository serves as a boilerplate and playground for integrating advanced UI components, authentication, cloud services, and real-time features using the latest web technologies.

Features

• User Authentication: Secure login, signup, and password reset functionality.
• Dashboard: Central dashboard for managing and visualizing all user and group activities.
• Group (Chama) Management: Create and manage collective savings groups (chamas) with dedicated modules.
• Savings: Track group and individual savings transactions.
• Loans: Request, approve, and manage group or personal loans.
• Investments: Collaborative investment tracking and management.
• Payments: Integrated payment processing for savings, loans, and investments.
• Profile Management: User profile and settings management.
• Support Center: Access help and support resources within the app.
• API-first Architecture: Extensible with API routes for backend integrations.
• Modern UI/UX: Built with React 19, Next.js 15, Tailwind CSS, and Radix UI for a modern, responsive interface.
• Real-Time & AI Features: Pusher/WebSocket for live updates and AI SDK integration for generative features.

Directory Structure (partial)

• /app - Main application code (pages, routes, API handlers)
  • /api - API route handlers
  • /chama & /chama-hub - Group savings and management
  • /dashboard - User/group dashboard
  • /forgot-password, /login, /signup - Authentication flows
  • /investments, /loans, /payments, /savings - Financial modules
  • /profile - User profile management
  • /support - Help center and support
• /components - Reusable React components and UI elements
• /hooks - Custom React hooks
• /lib - Utility libraries and helpers
• /public - Static assets (images, fonts, etc.)
• /styles - Tailwind and global styles

Getting Started

1. Clone the repository

   git clone https://github.com/Khin-96/pochi.git
   cd pochi

2. Install dependencies

   npm install
   # or
   pnpm install

3. Set up environment variables

   • Create a .env.local file and add your secrets (see docs for each integration).

4. Run the development server

   npm run dev

5. View in browser Visit http://localhost:3000 to see the app running.

Scripts

• dev - Start development server
• build - Build the app for production
• start - Start the production server
• lint - Lint the codebase

Tech Stack

• Frontend: React, Next.js, Tailwind CSS, Radix UI
• Backend: Next.js API routes, MongoDB, WebSockets (Pusher)
• DevTools: TypeScript, ESLint, PostCSS, pnpm

License

This project is private and not licensed for distribution.

---

Author: Khin-96