[{"_1":2,"_154":-5,"_155":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_133":134},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_124":-5,"_125":11,"_126":17,"_127":11,"_128":-5,"_129":11,"_130":-5,"_131":132},"canonicalUrl","https://hub.docker.com/r/geraldkugie/summit/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","geraldkugie","reponame","summit","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":58,"_60":61,"_62":-5,"_63":64,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2025-05-12T07:23:13.082562Z","description","","is_private","last_updated","2025-06-06T15:36:52.370684Z","last_modified","2025-05-12T14:19:01.780023Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",402,"repository_type","star_count",1,"status","status_description","active","source","collaborator_count",0,"full_description","![og-image-summit](https://github.com/user-attachments/assets/33ed60b2-606b-4b80-8526-9315517b4f92)\n

Summit

\n\n

\n Open Source Invoicing & Finance App. Created by Kugie\n

\n\n

\n \n \n \n \n

\n\n

\n \n $\"Deploy$ \n \n

\n\n**[Summit](https://summitfinance.app)** is a modern, self-hostable invoicing and financial management application designed for freelancers, small businesses, and agencies. Built with Next.js, Drizzle ORM, and Tailwind CSS, it provides the essential tools to manage your finances efficiently.\n\n---\n\n**Maintained by [Kugie.app](https://www.kugie.app)**\n

Background

\n\nWe've tried several tools including Akaunting (not familiar with PHP), InvoiceNinja (limited functionality), Crater, and Twenty CRM (consume too much CPU and RAM). We just want a tool that helps us create quotations, send invoices through email, and automate payments.\n\n

\n\nThis open-source project is proudly maintained by the team at [Kugie.app](https://www.kugie.app). We believe in the power of open source and welcome contributions from the community!\n\nWhether you want to fix a bug, add a feature, or improve documentation, feel free to:\n\n* Fork the repository and create a Pull Request.\n* Open an issue to discuss bugs or new features.\n* [Contact us](https://www.kugie.app/contact) to talk about the project!\n\n## YouTube: Getting Started with Summit Finance\n[![Getting Started with Summit Finance](https://img.youtube.com/vi/6mJjokNKlq8/maxresdefault.jpg)](https://www.youtube.com/watch?v=6mJjokNKlq8)\n\n## ✨ Key Features\n\n![summit og](https://github.com/user-attachments/assets/3bf5edd5-db8c-4195-8e03-38110e2b7e3d)\n\n\n* **📄 Invoicing:** Create, manage, and track professional invoices.\n * Generate PDF invoices.\n * Send invoices directly via email.\n * Track invoice statuses (Draft, Sent, Paid, Overdue, Cancelled).\n * Online payment integration (Xendit).\n* **📝 Quoting:** Create and manage quotes for clients.\n * Generate PDF quotes.\n * Send quotes directly via email.\n * Track quote statuses (Draft, Sent, Accepted, Rejected, Expired).\n * Convert accepted quotes directly into invoices.\n* **💸 Expense Tracking:** Record and categorize business expenses.\n * Upload and attach receipts (via Minio/S3).\n * Manage expense categories.\n* **💰 Income Tracking:** Record and categorize income sources.\n * Link income to specific invoices or clients.\n * Manage income categories.\n* **👥 Client Management:** Keep track of your clients' information.\n* **🏪 Vendor Management:** Manage information about your suppliers and vendors.\n* **🔄 Recurring Transactions:** Set up recurring invoices, expenses, and income on daily, weekly, monthly, or yearly schedules. Automated processing via cron job endpoint.\n* **📊 Dashboard:** Get a quick overview of your financial health (Outstanding/Overdue Invoices, Profit & Loss).\n* **📈 Reporting:** Generate insightful financial reports:\n * Profit & Loss Statement\n * Invoice Summary\n * Aging Receivables\n * Expense Breakdown\n * (More planned!)\n* **🚪 Client Portal:** A dedicated portal for clients to view their invoices and quotes (authentication via magic link).\n* **👥 Team Management:** Invite team members with different roles (Admin, Accountant, Staff) and permissions.\n* **⚙️ Settings:** Configure company details, manage categories, and team members.\n* **🔒 Authentication:** Secure user authentication using NextAuth.js.\n* **📱 Modern Tech Stack:** Built with Next.js (App Router), TypeScript, Tailwind CSS, shadcn/ui, Drizzle ORM, and PostgreSQL.\n\n## 🚀 Tech Stack\n\n* **Framework:** Next.js (App Router)\n* **Language:** TypeScript\n* **Styling:** Tailwind CSS with shadcn/ui\n* **Database:** PostgreSQL\n* **ORM:** Drizzle ORM\n* **Authentication:** NextAuth.js\n* **Email:** Resend\n* **Payments:** Xendit\n* **File Storage:** Minio (or any S3-compatible storage)\n* **Validation:** Zod\n* **Forms:** React Hook Form\n\n## 🚢 Deployment\n\n### How the Kugie Team Deploys Summit\n\nWe use [Railway](https://railway.app/) for seamless deployment of the entire application stack:\n\n* **Main Application:** The Next.js application is deployed directly on Railway, which automatically handles builds and deployments from the GitHub repository.\n* **Database:** PostgreSQL is hosted as a Railway service, providing reliable database connectivity.\n* **MinIO Storage:** File storage for receipts and documents is also hosted on Railway, eliminating the need for external S3 providers.\n* **Webhook Processing:** For efficient webhook handling, the team uses Railway Functions with [Hono](https://hono.dev/) (a lightweight web framework). The webhook implementation can be found in the [xendit-webhook.js](xendit-webhook.js) file at the root of the project.\n\nThis infrastructure setup provides a cost-effective, reliable deployment that scales with usage while keeping all components within the same platform for easier management.\n\n[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/template/x5njSj?referralCode=D8ivdW)\n\n## 🔄 Webhook Integration\n\n### Xendit Payment Webhooks\nSummit is fully compatible with Xendit webhooks to automate your payment workflow:\n\n* **Automatic Invoice Updates:** When a payment is completed through Xendit, the webhook automatically updates the corresponding invoice status to \"Paid\" in your Summit dashboard.\n* **Real-time Slack Notifications:** Get instant notifications in your Slack workspace whenever a payment is received, keeping your team informed without manual checks.\n* **Secure Verification:** All incoming webhook requests are verified using Xendit's callback verification token to ensure data integrity and security.\n\nTo set up Xendit webhooks:\n1. Configure your Xendit dashboard to point to your Summit instance's webhook endpoint (`/api/webhooks/xendit`)\n2. Ensure your `XENDIT_CALLBACK_VERIFICATION_TOKEN` is properly set in your environment variables\n3. Configure Slack notifications by adding your Slack webhook URL to the environment variables:\n\n\n## 🏁 Getting Started\n\nFollow these steps to get the Summit application running locally.\n\n### Prerequisites\n\n* Node.js (v18 or later recommended)\n* pnpm (or npm/yarn)\n* PostgreSQL Database\n* Minio Server (or other S3-compatible storage)\n\n### Installation\n\n1. **Clone the repository:**\n ```bash\n git clone https://github.com/kugie-app/summit.git\n cd summit\n ```\n\n2. **Install dependencies:**\n ```bash\n pnpm install\n ```\n\n3. **Set up environment variables:**\n Copy the `.env.example` file to `.env` and fill in the required values.\n ```bash\n cp .env.example .env\n ```\n See the [Environment Variables](#-environment-variables) section below for details.\n\n4. **Set up the database:**\n Make sure your PostgreSQL server is running and the connection string in your `.env` file is correct. Then, run the database migrations:\n ```bash\n pnpm run generate && pnpm run push\n ```\n *Note: `generate` and `push` are suitable for development. For production, use `drizzle-kit generate` and apply migrations manually or via a migration tool.*\n\n5. **Run the development server:**\n ```bash\n pnpm run dev\n ```\n\n6. **Open your browser:**\n Navigate to [http://localhost:3000](http://localhost:3000).\n\n### 🔑 Environment Variables\n\nCreate a `.env` file in the root of the project and add the following variables:\n\n```env\n# Database\nDATABASE_URL=\"postgresql://user:password@host:port/database?sslmode=require\" # Your PostgreSQL connection string\n\n# Authentication (NextAuth.js)\n# Generate a secret: openssl rand -base64 32\nNEXTAUTH_SECRET=\"YOUR_NEXTAUTH_SECRET\"\nNEXTAUTH_URL=\"http://localhost:3000\" # Use your production URL in deployment\n\n# Client Portal Authentication Secret (Used for client portal JWTs)\n# Generate a strong secret\nCLIENT_AUTH_SECRET=\"YOUR_STRONG_CLIENT_PORTAL_SECRET\"\n\n# User Signup Control\n# Set to \"1\" to disable new user signups\nNEXT_PUBLIC_DISABLE_SIGNUP=\"0\"\n\n# Email (Resend)\nRESEND_API_KEY=\"YOUR_RESEND_API_KEY\"\nRESEND_FROM_EMAIL=\"you@yourdomain.com\" # Email address verified with Resend\n\n# Payment Gateway (Xendit)\nXENDIT_SECRET_KEY=\"YOUR_XENDIT_SECRET_KEY\"\nXENDIT_CALLBACK_VERIFICATION_TOKEN=\"YOUR_XENDIT_CALLBACK_TOKEN\" # Set this in Xendit dashboard\n\n# File Storage (Minio/S3)\nMINIO_ENDPOINT=\"localhost\"\nMINIO_PORT=\"9000\"\nMINIO_USE_SSL=\"false\"\nMINIO_ACCESS_KEY=\"minioadmin\"\nMINIO_SECRET_KEY=\"minioadmin\"\nMINIO_BUCKET_NAME=\"summit\"\n\n# Cron Job Security\n# A secret key to authenticate requests to the cron job endpoint\nCRON_API_KEY=\"YOUR_SECURE_CRON_API_KEY\"\n\n# Application URL (Used for generating links in emails etc.)\nNEXT_PUBLIC_APP_URL=\"http://localhost:3000\" # Use your production URL in deployment\n```\n\n### 💾 Database Setup\n\nThis project uses Drizzle ORM with PostgreSQL.\n\n1. **Ensure PostgreSQL is running.**\n2. **Set your `DATABASE_URL` in the `.env` file.**\n3. **Apply migrations (development):**\n ```bash\n pnpm db:push\n ```\n4. **Generate new migrations (when schema changes):**\n ```bash\n pnpm db:generate\n ```\n Then apply the generated migration script to your database.\n## Docker Images\n\nLast Stable Version: 1.0.0\n```\ndocker pull geraldKugie/summit:1.0.0\n\ndocker run -p 3000:3000 -e = geraldKugie/summit:1.0.0\n```\n\nNotes:\n- On local builds, its simpler to run it from local directly without using docker, since you don't have to pass env vars one by one by using `-e =`, or if you still want to containerize the app, use the `docker compose up` command for easier variable injection. \n- The image have been tested to deploy on railway, with all the envs provided, it will work perfectly. \n- Other methods such as implementing a specific config file for envs (e.g loki-config.yaml for loki) or passing a `.env` file are not implemented yet, but **will be implemented in the future.** \n\n\n\n\n## 🤝 Contributing\n\nContributions are welcome! We appreciate any help, from bug fixes and feature enhancements to documentation improvements.\n\nPlease read our [Contributing Guidelines](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.\n\nYou can also reach out to the maintainers at [Kugie.app](https://www.kugie.app/contact).\n\n## 📄 License\n\nThis project is licensed under the [MIT LICENSE](LICENSE)","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",148641751,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":98,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":61,"_123":17},"content_type","creator",34570470,"digest","sha256:b8c8dc6ebde38be637daf95d06b4010b15cc09caa8b4e7e77919315d48cc40d0","full_size",74393827,"id",897418403,"images",[99],{"_100":101,"_91":92,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":94,"_59":61,"_112":-5},"architecture","amd64","features","last_pulled","2026-09-13T22:51:53.391131307Z","last_pushed","2025-06-06T15:36:50.86159993Z","os","linux","os_features","os_version","size","variant","2025-06-06T15:36:51.285073Z","last_updater","last_updater_username","media_type","1.0.0","repository",27348990,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":135,"_142":143,"_131":152,"_153":11},{"_36":136,"_38":137,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":138,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":58,"_60":61,"_62":-5,"_63":64,"_65":66,"_67":11,"_68":29,"_69":139,"_75":11,"_76":141,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":140},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_144":58,"_145":-5,"_146":-5,"_147":148},"count","next","previous","results",[149],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":150,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":61,"_123":17},[151],{"_100":101,"_91":92,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":94,"_59":61,"_112":-5},[],"canDeleteTags","actionData","errors"]

geraldkugie/summit

Tags for geraldkugie/summit