<zr/>
Back to Projects

Projects Work

A collection of full-stack projects by Zaidibeth Ramos — from Web3 platforms to financial dashboards and localization systems.

Filter by skill
Group by
Arkano
arkano

Arkano

App Summary: Arkano Arkano is a modern, AI-powered platform for Tarot and Esotericism. It acts as an interactive tool that provides users with deep, personalized tarot readings generated by artificial intelligence. Key Features: AI-Powered Readings: Uses Google Gemini to generate custom interpretations of tarot card spreads. Esoteric RAG (Retrieval-Augmented Generation): The AI's interpretations are grounded in actual esoteric PDF manuals that have been parsed and loaded into a vector database, ensuring high-quality, specialized responses. Credit & Wallet System: Users have a digital wallet to manage credits. They get daily free readings and can purchase more credits through integrations like Stripe or "Pago Móvil". Multilingual Support: Fully supports English and Spanish. Admin Dashboard: Includes an administration panel to manage users, assign funds, review support tickets, and configure global settings. Native Automations: Uses background database cron jobs (pg_cron) to handle daily resets, like giving out daily free credits. 🛠️ Technology Stack The project is built on a modern, full-stack JavaScript/TypeScript ecosystem. Core & Frontend: Framework: Next.js 16.1 (using App Router) Language: TypeScript and React 19 Styling: Tailwind CSS v4 Icons: Lucide React Internationalization (i18n): next-intl Markdown Rendering: react-markdown and remark-gfm (likely used to render the AI's rich-text responses cleanly) Backend & Infrastructure: Database, Auth & Storage: Supabase Uses Supabase Auth for session handling and role-based access control (Admin vs. User). Uses PostgreSQL (with pgvector for RAG capabilities) and pg_cron for database-level task scheduling. AI Integration: Google Gemini (@google/genai) Payments & Emails: Payments: Stripe integration Transactional Emails: Resend Analytics & Monitoring: Analytics: PostHog (posthog-js, posthog-node) and Vercel Analytics (@vercel/analytics) Utilities / Scripts: PDF Processing: pdf-parse (used in backend scripts to ingest the esoteric manuals for the RAG architecture)

Live Demo
Zergcore.dev V2
Next.js 15FastAPINeon DBFramer Motion

Zergcore.dev V2

This project, Zergcore, is a modern full-stack web application built for a professional portfolio and CMS platform. It features a decoupled architecture with a high-performance Python backend and a reactive TypeScript frontend, designed with a focus on AI integrations and asset management. Project Summary Zergcore serves as a digital headquarters, likely managing professional assets like resumes, portfolio projects, and AI-driven features (such as the "AI CV Architect"). The project is currently transitioning from a legacy Django system to a modern FastAPI + Next.js stack to improve performance, scalability, and developer experience. Architectural Overview 1. Backend (The "Brain") The backend is built with FastAPI, emphasizing speed and type safety. Framework: FastAPI for the REST API layer. Database & ORM: SQLAlchemy 2.0 (Asynchronous) with PostgreSQL (via asyncpg). Migrations: Alembic manages database schema versions. Security: JWT-based authentication using python-jose and bcrypt. Integrations: Cloudinary: Handles image and document (PDF) storage. Resend: Manages transactional emails. AI/PDF Tools: Uses pypdf for document processing, with hooks for LLM integrations. Legacy Path: A _legacy_django directory exists, containing the original codebase being phased out. 2. Frontend (The "Face") The frontend is a cutting-edge Next.js 15 application. Framework: Next.js (App Router) with React 19. Styling: Tailwind CSS v4 for a utility-first, modern design system. Animations: Framer Motion provides high-end micro-animations and transitions. Icons: Lucide React and React Icons. Type Safety: Strict TypeScript implementation throughout the UI and API client layers. 3. Infrastructure & Workflow Monorepo-lite: Organized into clear /backend and /frontend directories. Deployment: Docker-ready (via Dockerfile in backend) and optimized for platforms like Vercel (frontend) and traditional cloud providers. Dev Experience: Uses uvicorn with uvloop for the backend development server and Next.js Turbopack for the frontend. Directory Highlights backend/app/models/: SQLAlchemy database models. backend/app/routers/: API endpoints organized by feature. frontend/app/: Next.js App Router pages and layouts. frontend/components/: Reusable UI components. docs/: Project documentation (including historical context like btw.txt).

Live Demo

Like What You See?

I'm open to new opportunities. Let's discuss how I can bring this level of engineering to your team.

Let's Talk