whatisgithub

What is livre-des-recettes?

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

Analysis updated 2026-05-18

62JavaScriptAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

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

Mindmap

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 build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

Node.jsJavaScript

How does it compare?

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 you get it running?

Difficulty · easy Time to first run · 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.

So what is it?

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.

Copy-paste prompts

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?

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.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.