{"id":29028430,"url":"https://github.com/durga1534/freelance_flow","last_synced_at":"2026-04-12T00:36:05.477Z","repository":{"id":301291559,"uuid":"1008145034","full_name":"Durga1534/Freelance_Flow","owner":"Durga1534","description":"A Full-Stack Freelancer Website to work on projects with time tracking, clients list, invoices with live time tracking feature as well. Build using Next.js 15 with TypeScript","archived":false,"fork":false,"pushed_at":"2025-06-26T04:59:55.000Z","size":138,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-26T05:31:31.673Z","etag":null,"topics":["appwrite","expressjs","nextjs","nodejs","react-hook-form","shadcn","stripe","tailewindcss","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/Durga1534.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-06-25T05:22:20.000Z","updated_at":"2025-06-26T04:59:58.000Z","dependencies_parsed_at":"2025-06-26T05:41:41.248Z","dependency_job_id":null,"html_url":"https://github.com/Durga1534/Freelance_Flow","commit_stats":null,"previous_names":["durga1534/freelance_flow"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Durga1534/Freelance_Flow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Durga1534%2FFreelance_Flow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Durga1534%2FFreelance_Flow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Durga1534%2FFreelance_Flow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Durga1534%2FFreelance_Flow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Durga1534","download_url":"https://codeload.github.com/Durga1534/Freelance_Flow/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Durga1534%2FFreelance_Flow/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262018884,"owners_count":23245626,"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","expressjs","nextjs","nodejs","react-hook-form","shadcn","stripe","tailewindcss","typescript"],"created_at":"2025-06-26T07:11:26.920Z","updated_at":"2026-04-12T00:36:05.469Z","avatar_url":"https://github.com/Durga1534.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 FreelanceFlow\n\n**Modern Client Management Platform for Freelancers**\n\nA full-stack web application built to demonstrate modern web development skills while solving real freelance business challenges. Features client management, project tracking, time logging, and invoice generation with Stripe integration.\n\n[![Live Demo](https://img.shields.io/badge/Live-Demo-brightgreen)](https://freelance-flow-xi.vercel.app/)\n[![Build Status](https://img.shields.io/badge/build-passing-brightgreen)](https://github.com/Durga1534/Freelance_Flow)\n![CodeQL](https://github.com/Durga1534/Freelance_Flow/actions/workflows/codeql.yml/badge.svg)\n\n\n\n## 📸 Screenshots\n\n### Dashboard Overview\n![Dashboard](public/freelance_dashboard.png)\n*Clean, intuitive dashboard with project and client insights*\n\n### Client Management\n![Client Management](public/clients.png)\n*Complete client management with contact information and project history*\n\n### Project Management\n![Project Management](public/projects.png)\n*Project tracking with progress monitoring and details*\n\n### Invoice Generation\n![Invoice System](public/invoices.png)\n*Professional invoice generation with Stripe payment integration*\n\n### Time Tracking\n![Time Tracking](public/time-tracking.png)\n*Real-time project time tracking with detailed logging*\n\n## ✨ Features\n\n### 📊 **Dashboard**\n- Real-time project and client overview\n- Quick action buttons for common tasks\n- Visual progress indicators\n- Revenue and time tracking summaries\n\n### 👥 **Client Management**\n- Complete client profiles with contact details\n- Project history per client\n- Client status tracking\n\n### 📋 **Project Management**\n- Create and manage projects\n- Track project progress and milestones\n- Assign projects to clients\n- Project status updates\n\n### ⏱️ **Time Tracking**\n- Start/stop timer for active projects\n- Detailed time logs with descriptions\n- Project-specific time categorization\n- Time reporting and analytics\n\n### 💰 **Invoice System**\n- Professional invoice generation\n- Stripe payment integration\n- Invoice status tracking\n- PDF invoice download\n\n### 🔐 **Authentication**\n- Secure user registration and login\n- Protected routes and data\n- Session management\n\n## 🛠️ Technology Stack\n\n### **Frontend**\n- **Next.js 15** - React framework with App Router\n- **TypeScript** - Type-safe development\n- **Tailwind CSS** - Utility-first styling\n- **Shadcn/UI** - Modern React component library\n- **React Hook Form** - Form management and validation\n\n### **Backend \u0026 Database**\n- **Appwrite** - Backend-as-a-Service for database and auth\n- **Next.js Server Actions** - Server-side logic\n- **Zod** - Schema validation\n\n### **Integrations**\n- **Stripe** - Payment processing and invoice generation\n- **Recharts** - Data visualization for analytics\n\n### **Development Tools**\n- **ESLint** - Code linting and formatting\n- **Jest** - Unit testing setup\n- **TypeScript** - Static type checking\n\n## 🚀 Getting Started\n\n### Prerequisites\n- Node.js 18+ and npm\n- Appwrite account and project\n- Stripe account for payments\n\n## 📘 Docs\n- [🔐 Auth Flow](docs/auth-flow.md)\n\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/Durga1534/Freelance_Flow.git\ncd Freelance_Flow\n\n# Install dependencies\nnpm install\n\n# Set up environment variables\ncp .env.example .env.local\n# Add your Appwrite and Stripe credentials\n\n# Run development server\nnpm run dev\n\n# Visit http://localhost:3000\n```\n\n### Environment Variables\n\n```env\n# Appwrite Configuration\nNEXT_PUBLIC_APPWRITE_ENDPOINT=your_appwrite_endpoint\nNEXT_PUBLIC_APPWRITE_PROJECT_ID=your_project_id\nAPPWRITE_API_KEY=your_api_key\n\n# Stripe Configuration\nNEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=your_stripe_public_key\nSTRIPE_SECRET_KEY=your_stripe_secret_key\n\n# Application URL\nNEXT_PUBLIC_APP_URL=http://localhost:3000\n```\n\n## 📦 Deployment\n\nDeployed on Vercel with automatic deployments from the main branch.\n\n```bash\n# Build for production\nnpm run build\n\n# Deploy to Vercel\nvercel --prod\n```\n\n## 🧪 Testing\n\n```bash\n# Run tests\nnpm test\n\n# Run tests in watch mode\nnpm run test:watch\n```\n\n## 🎯 Project Goals\n\nThis project was built to:\n- Demonstrate full-stack development skills using modern technologies\n- Solve real freelance business management challenges\n- Practice integrating third-party services (Stripe, Appwrite)\n- Build a production-ready application with proper authentication\n- Showcase TypeScript and modern React patterns\n\n## 💡 Key Learning Outcomes\n\n- **Full-stack Development**: Built complete frontend and backend functionality\n- **Payment Integration**: Implemented Stripe for invoice processing\n- **Database Design**: Structured relational data with Appwrite\n- **Authentication**: Secure user management and protected routes\n- **TypeScript**: Type-safe development throughout the application\n- **Modern React**: Hooks, Server Components, and state management\n- **UI/UX Design**: Responsive design with Tailwind CSS and Shadcn/UI\n\n## 🚧 Technical Challenges Solved\n\n- Implementing real-time time tracking with start/stop functionality\n- Integrating Stripe payment processing with invoice generation\n- Building responsive dashboard with multiple data visualizations\n- Managing complex state between clients, projects, and time entries\n- Securing API routes and implementing proper authentication flows\n\n## 👨‍💻 Author\n\n**Durga Prasad Konduru**\n- Portfolio: [Durga Prasad] (https://durga-prasad-portfolio1.vercel.app/)\n- LinkedIn: [@durgaprasad23](https://www.linkedin.com/in/durgaprasad23)\n- Email: kondurudurgaprasad.2@gmail.com\n\n## 🤝 Contributing\n\nContributions, issues, and feature requests are welcome!\n\n1. Fork the project\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n\u003cdiv align=\"center\"\u003e\n  \u003cstrong\u003eBuilt with ❤️ to learn and grow as a developer\u003c/strong\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdurga1534%2Ffreelance_flow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdurga1534%2Ffreelance_flow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdurga1534%2Ffreelance_flow/lists"}