The Cognitive Distortion Journal (CDJ) is a smart journaling tool designed to assist in addressing distorted thinking patterns. It can often be challenging to practice Cognitive Behavioral Therapy (CBT) techniques, which involve identifying distorted thoughts and reframing them, especially when cognitive distortions are actively happening. The CDJ simplifies this process by employing AI to recognize cognitive distortions and guide you in reframing your thoughts effectively.
Contents
The CDJ is a full-stack web application built on the MERN stack (MongoDB, Express, React, Node.js). The frontend is built with React, Material UI and Vite, and the backend is built with Node.js and Express.
The application uses MongoDB as its database and Redis for session management. Nodemailer is used to send emails for account verification and password reset. Passport and JWT are used for authentication. Jest is used for testing and ESLint is used for linting.
OpenAI's completions API is used to analyze journal entries for cognitive distortions, provide feedback on how to reframe them, and additional conversational support.
Download the installer from the official Node.js website: https://nodejs.org/en/download/
For macOS, install MongoDB using Homebrew:
# Install Homebrew
brew tap mongodb/brew
brew install mongodb-community@5.0
# To start the MongoDB server after installation
brew services start mongodb-community@5.0
# Verify that MongoDB is running
brew services listFor Windows, install MongoDB using the MSI installer from the official MongoDB website: https://www.mongodb.com/try/download/community
"C:\Program Files\MongoDB\Server\5.0\bin\mongod.exe" --dbpath="c:\data\db"Redis is used for session management in production. For local development, you can skip this step and use the default session management provided by Express.
To develop in a production-like environment, follow the instructions below to install Redis.
On macOS, install Redis using Homebrew:
# Install Homebrew
brew install redis
# To start the Redis server after installation
brew services start redis
# Verify that Redis is running
brew services listOn Windows, install Redis using the MSI installer from the official Redis website: https://redis.io/download
"C:\Program Files\Redis\redis-server.exe"Once Redis is installed, run the project in production mode by setting NODE_ENV to production in the .env file in the backend directory. See Create Backend .env for more information.
git clone https://github.com/hiyaryan/the-cdjThis project uses git and GitHub for version control and collaboration. If you are unfamiliar with git or GitHub, see the Git Handbook and GitHub Docs for more information.
cd the-cdj
npm installIf you encounter an error, ensure that Node.js and npm are installed correctly. See Install Node.js and npm for instructions on how to install Node.js and npm.
.envCreate a file named .env in the frontend directory and add the following environment variables:
VITE_RELEASE_PHASE=beta # Determines which code paths to execute based on the release phase
VITE_ACCESS_URL=http://localhost:3000/access # Used for API requests
VITE_ENTRIES_URL=http://localhost:3000/journals/ # Used for API requests.envCreate a file named .env in the backend directory and add the following environment variables:
Ensure you replace items in angle brackets '<>' with your own values.
NODE_ENV=development # Default environment is development
RELEASE_PHASE=beta # Determines which code paths to execute based on the release phase
DOMAIN=<LAN_IPv4_ADDRESS> # (or localhost) Used to construct magic link URLs
PORT=3000 # Used to construct magic link URLs
ORIGIN_SELF=http://localhost:5173 # Used for CORS
ORIGIN_LOCAL=http://<LAN_IPv4_ADDRESS>:5173 # Used for CORS
TOKENIZED_URL=http://<LAN_IPv4_ADDRESS>:5173 # Used to construct magic link URLs
MONGODB_URI=mongodb://localhost:27017 # Used for connecting to MongoDB
OPENAI_API_URL=https://api.openai.com/v1 # Used for requests to OpenAI completions API
OPENAI_API_KEY=<OPENAI_API_KEY> # Used for requests to OpenAI completions API
SESSION_SECRET=<SESSION_SECRET> # Used for session management
JWT_SECRET=<JWT_SECRET> # Used for JWT authentication
SMTP_HOST=smtp.gmail.com # Used for sending emails (see below for Gmail setup)
SMTP_USER=<SMTP_USER> # Username for SMTP_HOST
SMTP_PASS=<SMTP_PASS> # Password for SMTP_USER
SMTP_NAME=<SMTP_NAME> # Name for emails sent from SMTP_USER
ADMIN_INBOX=<ADMIN_INBOX> # Email address for admin inbox
SUPPORT_INBOX=<SUPPORT_INBOX> # Email address for support inbox
SYSTEM_INBOX=<SYSTEM_INBOX> # Email address for system inbox
REDIS_HOST=localhost # Used for session management
REDIS_PORT=6379 # Used for session managementnode backend/data/seed.jsIf you encounter an error, ensure that the MongoDB server is running. See Install MongoDB for instructions on how to start the MongoDB server after installation.
Run the dev servers from the root directory.
npm run devThis project uses concurrently to run the frontend and backend servers at the same time. The command above installs the dependencies then launches their respective servers. The frontend Vite server runs on port 5173 and the backend Nodemon server runs on port 3000.
Alternatively, you can run the frontend and backend servers separately by navigating to their respective directories and running the start command:
cd frontend
npm run devcd backend
npm run devOpen the project in your browser at http://localhost:5173 (or http://
Each directory has its own tests. To run the tests for a specific directory, navigate to that directory and run the test command:
npm run testEach directory has its own linting configuration. To run the linter for a specific directory, navigate to that directory and run the lint command:
npm run lintContributions are welcome!
Please read the CONTRIBUTING.md file for more information on how to contribute to this project.
If you're interested in becoming a core member of our organization, feel free to connect with the project owner, Ryan Meneses, on LinkedIn.
Thank you for your interest in The CDJ! 🌟