File Types
This page is synthesized from the files in this repository. It focuses on source, configuration, documentation, migration, and local runtime files that are part of how the project is built or operated.
Generated build artifacts under .next/, dependency internals under node_modules/, and Git internals under .git/ are not application source even though they may exist on disk locally.
| File type | What it is for | Examples in this repo |
|---|---|---|
.ts | TypeScript files that hold server route logic, shared library code, scripts, and the local news-agent pipeline. These are plain TypeScript modules without JSX. | agents/news/run.ts, agents/news/classify.ts, app/api/articles/route.ts, lib/db.ts, lib/social/twitter.ts, scripts/linkedin-auth.ts, tailwind.config.ts |
.tsx | TypeScript plus JSX for React and Next.js UI. These files define app pages, layouts, client components, and shadcn/ui components. | app/layout.tsx, app/dashboard/layout.tsx, app/dashboard/articles/page.tsx, app/login/page.tsx, components/ui/card.tsx, components/ui/table.tsx |
.prisma | The Prisma schema that defines the database models, fields, relationships, enums, and Prisma Client generation settings shared by the agent and dashboard. | prisma/schema.prisma |
.sql | Generated Prisma migration SQL. These files record schema changes produced by Prisma migrations; they are not hand-written application logic. | prisma/migrations/20260806115744_init/migration.sql, prisma/migrations/20260806175900_add_run_log/migration.sql, prisma/migrations/20260807000000_add_publish_fields/migration.sql |
.md | Markdown documentation for the README, architecture notes, troubleshooting notes, glossary, and milestone/task notes. | README.md, docs/README.md, docs/build-guide.md, docs/architecture.md, docs/tech-stack.md, docs/data-flow.md, docs/troubleshooting.md, docs/setup-guides.md, docs/how-i-supervised-codex.md, docs/glossary.md |
.json | Structured configuration and dependency metadata. package.json defines scripts and dependencies; package-lock.json pins exact dependency versions; components.json configures shadcn/ui; tsconfig.json configures TypeScript; .eslintrc.json configures linting. | package.json, package-lock.json, components.json, tsconfig.json, .eslintrc.json |
.env / .env.example | Environment configuration and secrets. Real .env files hold local values such as database URLs, admin credentials, AI provider settings, and social posting credentials. .env.example documents the expected keys without real secrets. | .env, .env.local, .env.example |
.plist | macOS launchd scheduling configuration. The checked-in plist template describes how to run the local news agent automatically on a schedule. | scripts/com.ainewsplatform.dailyrun.plist.template |
.sh | Shell scripts for running project commands with explicit environment setup, especially PATH setup for unattended macOS scheduling. | run-agent.sh, dev-server.sh, launch-task7.sh |
.yml | YAML service configuration. The Docker Compose file defines local Postgres for local-only database testing. | docker-compose.yml |
.gitignore | Git ignore rules that tell Git what not to track, such as dependencies, build output, local environment files, and runtime artifacts. | .gitignore |
.css | Global stylesheet files. The app uses Tailwind utilities in JSX, but global CSS still defines Tailwind layers and design-token variables. | app/globals.css |
.mjs | JavaScript configuration files using ES module syntax. | next.config.mjs, postcss.config.mjs |
.toml | TOML metadata used by Prisma migrations to record migration-provider locking information. | prisma/migrations/migration_lock.toml |
.txt | Plain text prompt templates and provider notes. The news agent prompt files are readable text that can seed or describe prompt behavior. | agents/news/prompts/classify.txt, agents/news/prompts/linkedin_post.txt, agents/news/prompts/twitter_post.txt |
.template | Template suffix used for a file that must be copied and customized before use. In this repo it appears on the launchd plist template. | scripts/com.ainewsplatform.dailyrun.plist.template |