Repository files navigation

Anima + Aura. A Fullstack API with Management Dashboard focused on Performance, Scalability and Modularity.

• Docker - Lightweight and Ready to deploy.
• TypeScript - Full type safety and better developer experience
• pnpm - Performant package management focused on minimal package size and resources
• Node - a cross-platform, open-source JavaScript runtime environment.
• Passport.js - flexible and modular authentication middleware.
• ESLint, Prettier, Husky and Lint-Staged - Automated Code Quality and Beautification.

Two implementation branches

Archon - Dedicated Server API and Management Framework

Aevus - Master Server API and Management Framework

aspira├──-archon    ├──archon-edge├──-aevus    ├──aevus-edge

• React 19 - Latest React version with modern features.
• React Router v7 - File-based routing with nested layouts
• TypeScript - Full type safety and better developer experience
• TanStack Query - Powerful data fetching and state management
• shadcn/ui - Beautiful and accessible UI components
• Tailwind CSS v4 - Modern utility-first CSS framework
• OAuth2 - Service-based Authentication Strategies.
• il8n - a powerful internationalization framework
• Vite - Fast build tool and development server.
• Vitest - Next generation testing framework powered by Vite.

• Express.js - a minimal and flexible Node.js web application framework.
• MikroORM/Postgres - TypeScript ORM for Node.js.
• Axios - Promise based HTTP client for the browser and node.js.
• HMAC - Cryptographically secured API transactions.
• Vitest - Next generation testing framework powered by Vite.

1. Connect to Database

Create '.env' file

In the root of the project, create a file named .env and define the necessary environment variables for your database connection. For example:

DB_DRIVER=postgresqlDB_HOST=localhostDB_PORT=5432DB_USER=your_userDB_PASSWORD=your_passwordDB_NAME=your_database_name

2. Setup OAuth

Install API Secrets

Start Backend

cd server   pnpm run dev

Start Frontend

cd client   pnpm run dev

Setup Endpoints

Open your browser

http://localhost:5173

Dockerfilesetup.shsetup.batclient/├──src/    ├── components/         # Reusable UI components    │   ├── app-sidebar/    # Sidebar navigation components    │   └── ui/             # shadcn/ui components    ├── hooks/              # Custom React hooks    ├── lib/                # Utility functions and configs    ├── routes/             # Route components and layouts    └── styles/             # Global styles and CSSserver/├──src/    ├── routes/             # API Routes

• pnpm run dev - Start development server
• pnpm run build - Build for production
• pnpm run preview - Preview production build
• pnpm run lint - Run ESLint

This project is open source and available under theMIT License.