The Codegen
About
- TL:DR
- Codegen is a tool that uses templates and data schema to generate custom code snippets or projects.
- Codegen is a programmable code-generation tool based on the Liquid template engine. It allows developers to create custom templates for generating code snippets, files, or entire projects from various data schema. Codegen also provides features such as user management, syntax highlighting, and formatting to make the code-generation process easier and faster.
Tech stacks used
Building & running the project
Before building or running, fill .env
- Create a .env file at the root level, with the following information
# required env variables
DATABASE_URL=GITHUB_ID=${github client id}
GITHUB_SECRET=${github secret}
NEXTAUTH_SECRET=
# optional env variables
NEXT_PUBLIC_PROJECT_NAME=${Project name, "The Codegen"}
NEXT_PUBLIC_PROJECT_DESCRIPTION_MAX_LENGTH=${New project description Length, 80}
NEXT_PUBLIC_REQUEST_REFRESH_INTERVAL=${value for SWR to refresh every n millisecond, 1000(1sec)}
# update datasource in schema.prisma file to
datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
}
Database setup
docker-compose up -d
- once you setup the .env files you can start building the project for both dev and prod environment
How to build the project for production
yarn add
yarn run vercel-build
yarn run start # then open localhost:3000
How to run the project locally
- right after cloning this project
1. yarn add
2. yarn run prisma generate
3. yarn run prisma db push
4. yarn run dev
- subsequent runs don't need the first 3 commands, unless you changed schema.prisma file.
yarn run dev
Prisma Commands to remember
#to access database ui interface by prisma
npx prisma studio
# to generate type definition
prisma generate
#to automatically generates SQL migration files and apply them to the database
npx prisma migrate dev --name migration_name
#to format and let prisma generate relation for you
prisma format
Note on Prisma migration commands
- When developing locally
- to sync your Prisma schema with the database schema of your local development database
- Use either
prisma migrate dev or prisma db push
- For CI/CD or production environment
prisma migrate deploy
