git404hub

what is livre-des-recettes fr?

rdsv01/livre-des-recettes — explained in plain English

Analysis updated 2026-05-18

62JavaScriptAudience · generalComplexity · 2/5LicenseSetup · easy

tl;dr

A local, spreadsheet free app for French micro entrepreneurs to keep their legally required income and purchase records with automatic totals and exports.

vibe map

mindmap
  root((repo))
    What it does
      Track income records
      Track purchase records
      Estimate contributions
      Export legal PDFs
    Tech stack
      Node.js
      JavaScript
      Local-first storage
    Use cases
      Replace spreadsheet bookkeeping
      Track VAT and income thresholds
      Export URSSAF ready reports
    Audience
      French freelancers
      Micro entrepreneurs
    Data
      100 percent local
      No account needed

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Keep a French micro entrepreneur's legally required income and purchase registers without using a spreadsheet.

VIBE 2

Track progress toward the micro entrepreneur income cap and VAT threshold as the year goes on.

VIBE 3

Export income and purchase records as compliant PDF, Excel, or CSV files with monthly and yearly totals.

VIBE 4

Estimate social security contributions owed for a chosen month, quarter, or year.

what's the stack?

Node.jsJavaScript

how it stacks up fr

rdsv01/livre-des-recettesgaearon/disposables1utkarsh1/mcp-stdio-guard
Stars626261
LanguageJavaScriptJavaScriptJavaScript
Last pushed2018-01-07
MaintenanceDormant
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Ships as a ready made executable per operating system, so no installation is required unless running it from source with Node.js.

Use, modify, and share freely, including for commercial purposes, as long as you keep the copyright notice.

in plain english

Livre des recettes is a simple local application built for French micro entrepreneurs, the self employed status common in France, to replace the spreadsheet many of them use to track their income and purchases for legal record keeping. It runs entirely on your own computer with no account and no internet connection needed, and it is meant to do one job well rather than act as a full accounting or invoicing system. French micro entrepreneurs are legally required to keep a chronological record of every payment they receive, called the livre des recettes, and if they buy and resell goods, a second record of their purchases, the registre des achats. This app covers both in one place, with guided entry, automatic totals, and record numbering checks that warn about duplicates or gaps without ever blocking your work. It also lets you save a client list so professional clients can be looked up automatically by their official French business registration number, and it flags recurring or very similar entries to help avoid accidental duplicate records. A dashboard shows monthly and yearly revenue, the number of payments received, and total purchases, along with a chart of revenue over time. Because micro entrepreneur status has income limits and VAT thresholds, the app tracks your progress toward those limits and warns you as you approach them, splitting the numbers by activity type if you both sell goods and provide services, since each has its own rules. It can also estimate the social security contributions due for a given period based on your declared activity type, entirely as a local calculation, with no direct connection to the French social security agency. Everything can be exported as PDF, Excel, or CSV files formatted to match legal requirements, complete with monthly and yearly totals, and the app reviews common compliance checks before every export. It also keeps automatic backups and can import your existing spreadsheet history through CSV files. The easiest way to run it is downloading a ready made executable for your operating system with nothing else to install, though it can also be run from source using Node.js. The project is released under the MIT license.

prompts (copy fr)

prompt 1
Help me download and run this app on my computer without installing Node.js.
prompt 2
Walk me through importing my existing Excel income history into this app as a CSV file.
prompt 3
Explain how this app splits my revenue between sales and services activity for URSSAF purposes.
prompt 4
Show me how the dashboard warns me as I approach the micro entrepreneur income threshold.

Frequently asked questions

what is livre-des-recettes fr?

A local, spreadsheet free app for French micro entrepreneurs to keep their legally required income and purchase records with automatic totals and exports.

What language is livre-des-recettes written in?

Mainly JavaScript. The stack also includes Node.js, JavaScript.

What license does livre-des-recettes use?

Use, modify, and share freely, including for commercial purposes, as long as you keep the copyright notice.

How hard is livre-des-recettes to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is livre-des-recettes for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.