Skip to content

HHHAAAANNNNN/ngitung-app

Repository files navigation

πŸ“Š NGITUNG

Kelola Usaha Dengan Mudah

React Native Expo TypeScript License

A modern, beautiful mobile application for managing business costs and calculating product pricing. Built with React Native and Expo, NGITUNG helps small business owners and entrepreneurs easily calculate Cost of Goods Sold (COGS/BPP) and determine optimal selling prices.


✨ Features

  • πŸ“ Create Multiple Business Notes - Organize different products or business ventures separately
  • πŸ’° Fixed Costs Management - Track monthly overhead costs like rent, utilities, salaries
  • πŸ“¦ Variable Costs Calculation - Manage per-unit costs with quantities (materials, packaging, etc.)
  • πŸ“Š Automatic BPP Calculation - Real-time Cost of Goods Sold calculation
  • πŸ’΅ Profit Margin Control - Set custom profit margins to determine selling prices
  • 🎨 Customizable Note Colors - Color-code your business notes for easy identification
  • πŸ” Search Functionality - Quickly find specific business notes
  • πŸ’Ύ Persistent Storage - All data is saved locally on your device
  • πŸŒ™ Beautiful Dark UI - Modern glassmorphism design with smooth animations
  • πŸ“± Cross-Platform - Works on iOS, Android, and Web

πŸ“± Screenshots

Home Screen

Home Screen - Empty State
Main Dashboard
Welcome screen to show all your notes!

Cost Management & Calculations

Note Settings
Fixed Cost
Something like tools and stuff
Results Page
Variable Cost
Something like ingredients and such
Calculation Results
Calculation Results
View BPP and selling price

Results & Settings

Detail Page - Variable Costs
Optimal Selling Price
Highlight of the Calculations
Detail Page - Fixed Costs
Cost Composition
Calculation Details
Notes List
Risk Simulation
Predict your risks!
Create New Note
Export to PDF
Share your Calculations

πŸš€ Getting Started

Prerequisites

Installation

  1. Clone the repository

    git clone https://github.com/HHHAAAANNNNN/ngitung-app.git
    cd ngitung-app
  2. Install dependencies

    npm install
  3. Start the development server

    npx expo start
  4. Run the app

    • iOS Simulator: Press i in the terminal
    • Android Emulator: Press a in the terminal
    • Web Browser: Press w in the terminal
    • Physical Device: Scan the QR code with the Expo Go app (iOS | Android)

πŸ“– How to Use

1. Create a Business Note

  • Tap the "+" floating action button on the home screen
  • Enter a name for your business calculation (e.g., "Bakso Ayam", "Kue Brownies")
  • Tap "Buat Catatan" to create the note

2. Add Fixed Costs

Fixed costs are monthly expenses that don't change with production volume:

  • Tap on your created note
  • Navigate to the "Biaya Tetap" section
  • Click "+ Tambah Biaya Tetap"
  • Enter cost name (e.g., "Sewa Kios", "Gaji Karyawan")
  • Enter monthly amount
  • Add as many fixed costs as needed

3. Add Variable Costs

Variable costs are per-unit expenses:

  • Scroll to the "Biaya Variabel" section
  • Click "+ Tambah Biaya Variabel"
  • Enter cost name (e.g., "Daging Ayam", "Tepung")
  • Enter unit price
  • Enter quantity per product
  • Add all your variable costs

4. Set Sales Projection & Profit Margin

  • Enter "Estimasi Penjualan" (estimated monthly sales units)
  • Enter "Margin Keuntungan" (profit margin percentage, e.g., 30 for 30%)

5. Calculate & View Results

  • Tap "Hitung" to calculate
  • The app will automatically calculate:
    • BPP (Biaya Pokok Produksi) - Cost of Goods Sold per unit
    • Harga Jual - Recommended selling price
  • Tap "Lihat Hasil Lengkap" to see detailed breakdown
  • Export results as PDF or share them

6. Customize & Manage Notes

  • Tap the three-dot menu on any note card
  • Choose a custom color for the note badge
  • Delete notes you no longer need

πŸ› οΈ Technology Stack


πŸ“ Project Structure

ngitung-app/
β”œβ”€β”€ app/                      # Main application code (Expo Router)
β”‚   β”œβ”€β”€ (tabs)/              # Tab-based navigation
β”‚   β”‚   β”œβ”€β”€ detail/          # Cost calculation detail pages
β”‚   β”‚   β”œβ”€β”€ result.tsx       # Results display page
β”‚   β”‚   └── _layout.tsx      # Tab layout configuration
β”‚   β”œβ”€β”€ index.tsx            # Home page with notes list
β”‚   └── _layout.tsx          # Root layout
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ context/             # React Context providers
β”‚   β”‚   └── NoteContext.tsx  # Note state management
β”‚   └── utils/               # Utility functions
β”œβ”€β”€ assets/                  # Images, fonts, and static files
β”œβ”€β”€ components/              # Reusable UI components
β”œβ”€β”€ constants/               # App constants and configuration
β”œβ”€β”€ screenshots/             # App screenshots for documentation
β”œβ”€β”€ app.json                 # Expo configuration
β”œβ”€β”€ package.json             # Dependencies and scripts
└── tsconfig.json            # TypeScript configuration

πŸ“œ Available Scripts

  • npm start - Start the Expo development server
  • npm run android - Open app in Android emulator
  • npm run ios - Open app in iOS simulator
  • npm run web - Open app in web browser
  • npm run lint - Run ESLint to check code quality

🀝 Contributing

Contributions are welcome! If you'd like to improve NGITUNG:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“„ License

This project is private. All rights reserved.


πŸ‘¨β€πŸ’» Author

HHHAAAANNNNN


πŸ™ Acknowledgments


Made with ❀️ for small business owners and entrepreneurs

If you find this project helpful, please consider giving it a ⭐!

About

React Native app to calculate production cost (BPP), pricing, profit margin, and break-even analysis for small businesses.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors