Economica

Economica is an open-source Discord economy bot that pairs a Discord.js bot with a Next.js web dashboard for managing server virtual economies. The repository is a Turborepo monorepo containing both the bot and the dashboard, with PostgreSQL for data storage and NextAuth for dashboard authentication.

What is Economica?

Economica is a full-stack Discord bot project designed to give Discord servers an economy system. It consists of a Discord.js bot that handles in-Discord interactions and a Next.js web dashboard for administration and visualization. The project uses PostgreSQL as its database and NextAuth for user authentication on the dashboard. The repository is structured as a Turborepo monorepo, enabling shared code and streamlined builds between the bot and web app.

Key Features

• Discord.js bot — Connects to Discord's API to process economy commands and events within a server.
• Next.js dashboard — Provides a web interface for viewing economy data and managing bot settings, built with React and Next.js.
• NextAuth authentication — Handles user login for the dashboard, supporting session-based access to administrative features.
• PostgreSQL database — Persists economy records, user profiles, and transaction history in a relational database.
• Turborepo monorepo — Organizes the bot and dashboard into a single repository with shared packages and efficient build pipelines.
• Learn-to-code resource — The repository is tagged "learn-to-code," indicating its suitability as an educational example of full-stack TypeScript development.

Who is it for?

• Discord server administrators — People who want to deploy a ready-made economy bot with an accompanying dashboard to manage their community's virtual currency.
• Full-stack developers — Those looking for a practical example of integrating a Discord bot with a web dashboard using modern tools like Next.js, NextAuth, PostgreSQL, and Turborepo.
• Learners — Coders studying bot development or full-stack JavaScript who can read and extend the monorepo to understand how the pieces fit together.

What can you do with Economica?

• Server admins: Deploy the bot and dashboard to offer members an in-server economy with a visual back-office for tracking balances and activity.
• Developers: Fork the repository and extend the bot with custom commands or add new dashboard pages using the existing Next.js and PostgreSQL setup.
• Students: Use the codebase as a study project to see how Discord.js events, Next.js API routes, and a shared database are wired together in a real application.

FAQ

What is Economica?

Economica is a Discord economy bot that includes a web dashboard. It is built on a Turborepo monorepo with a Discord.js bot and a Next.js frontend, using PostgreSQL and NextAuth.

What technologies does Economica use?

The stack includes Discord.js for bot functionality, Next.js for the dashboard, NextAuth for authentication, PostgreSQL for the database, and Turborepo for monorepo management.

Is Economica free to use?

The repository is publicly available on GitHub, so the source code can be used and modified. You will need to provide your own hosting and Discord bot credentials to run it.

Does Economica include a dashboard?

Yes, a Next.js dashboard is part of the repository, secured by NextAuth and connected to the same PostgreSQL database as the bot.

How many stars does the repository have?

The GitHub repository currently has 4 stars, indicating it is an early-stage project.