Take control of your financial future with intelligent insights and beautiful design
"Your money should work as hard as you do. Arthik makes it simple."
Arthik isn't just another expense trackerβit's your personal financial command center. Built for modern professionals who demand both power and simplicity.
π― Zero Learning Curve β Intuitive design that feels natural from day one
β‘ Lightning Fast β No loading screens, no lag, just pure performance
π¨ Beautiful Design β Professional aesthetic that doesn't sacrifice functionality
π± Mobile First β Perfect experience across all your devices
|
|
- Node.js 18+
- npm or yarn
- MongoDB Atlas account (free tier available)
# π₯ Clone the repository
git clone https://github.com/niyati34/Arthik.git
cd Arthik
# π¦ Install dependencies
npm install
# π§ Setup backend
cd backend
npm installCreate .env in the backend/ directory:
MONGODB_URI=your_mongodb_connection_string
JWT_SECRET=your_super_secret_key
PORT=5000
NODE_ENV=development# π₯οΈ Terminal 1: Start Backend
cd backend
npm run dev
# π Terminal 2: Start Frontend
cd ..
npm startπ That's it! Open http://localhost:3000 and start managing your finances like a pro!
"Simplicity is the ultimate sophistication" β Leonardo da Vinci
π― Minimalist First
Clean interfaces that focus on what matters mostβyour financial data.
β‘ Performance Obsessed
Sub-second load times and smooth interactions on every device.
π Consistent Experience
Unified color palette, typography, and spacing throughout the entire app.
βΏ Accessibility Built-in
WCAG AA compliant with full keyboard navigation and screen reader support.
/* π¨ Brand Colors */
Primary: #10b981 /* Success Green */
Secondary: #339989 /* Teal Accent */
Background: #ffffff /* Clean White */
Text: #1f2937 /* Rich Dark */
Subtle: #f8fafc /* Light Gray */ποΈ Arthik/
βββ οΏ½οΈ backend/ # API Server
β βββ π models/ # Database schemas
β βββ π£οΈ routes/ # API endpoints
β βββ βοΈ config/ # Configuration
βββ π src/ # React Frontend
β βββ π§© Components/ # Reusable UI components
β β βββ π Dashboard/ # Main dashboard
β β βββ π° Income/ # Income management
β β βββ πΈ Expenses/ # Expense tracking
β β βββ π― Goals/ # Goal setting
β β βββ π Charts/ # Data visualization
β βββ π¨ styles/ # Global styling
β βββ π context/ # State management
β βββ π οΈ utils/ # Helper functions
βββ οΏ½ docs/ # Documentation
# π§ͺ Run all tests
npm test
# π Test coverage report
npm run test:coverage
# π§ Lint code
npm run lint- 100% TypeScript coverage on critical paths
- Jest + RTL for comprehensive component testing
- ESLint + Prettier for consistent code style
- Accessibility testing with axe-core
Clean, minimal interface showing your financial health at a glance
| π° Income Management | πΈ Expense Tracking |
|---|---|
| π― Goal Setting | π Analytics |
|---|---|
οΏ½ Note: Add your screenshots to
docs/screenshots/to display them here
# ποΈ Build for production
npm run build
# π Deploy to Vercel
npx vercel --prod# Set environment variables
export MONGODB_URI=your_connection_string
export JWT_SECRET=your_secret
export NODE_ENV=production
# π Deploy
npm run start:prod- Functional Components with hooks
- Custom hooks for reusable logic (
useDataFiltering,useNotifications) - Styled-components for component styling
- Context API for global state management
- React.memo for expensive components
- useMemo/useCallback for derived values
- Lazy loading for route-based code splitting
- Optimized bundle with Webpack analysis
We welcome contributions! Here's how to get started:
- π΄ Fork the repository
- πΏ Create a feature branch (
git checkout -b feature/amazing-feature) - πΎ Commit your changes (
git commit -m 'Add amazing feature') - π€ Push to the branch (
git push origin feature/amazing-feature) - π― Open a Pull Request
# π§ Install dependencies
npm install && cd backend && npm install
# π§ͺ Run tests
npm test
# π¨ Check code style
npm run lint
|
|
|
MIT License - feel free to use this project for learning, personal use, or commercial applications.
β Star this repo if it helped you manage your finances better!
"Arthik empowers you to make every rupee count."