Cannot find module 'astro:content'

[azan-n]

What version of astro are you using?

1.8.0

Are you using an SSR adapter? If so, which one?

No

What package manager are you using?

npm, pnpm

What operating system are you using?

macOS 13

Describe the Bug

I have been eagerly waiting for even a beta of the Content Collections RFC to start shipping my blog. Thanks to @bholmesdev I got a chance much earlier than I could expect. I upgraded from 1.6.4(?) to 1.8.0 but I got the TS error Cannot find module 'astro:content' or its corresponding type declarations.ts(2307) when trying to import the defineCollection function.

Steps to reproduce

1. pnpm create astro@latest or npm create astro@latest
2. Create a 'content' directory and create a 'config.ts' within the folder
3. Write import { defineCollection, z } from "astro:content" within the 'config.ts'

Continuing with this state of the application leads to no errors during the build or in the dev server.

Link to Minimal Reproducible Example

https://stackblitz.com/edit/github-j2falm?file=content/config.ts

Participation

• I am willing to submit a pull request for this issue.

[bholmesdev]

Hey @azan-n! Yes, you’ll need to run a build or use our new sync command to generate this module. Try running pnpm astro sync in your terminal.

[azan-n]

Try running pnpm astro sync in your terminal.

I have tried this with npx, pnpm, and pnpx in separate repos. Regardless, the error does not go away.

EDIT: In all cases, I do get a message that reads [content] Types generated 34ms

[bholmesdev]

@azan-n hm, and do you see a src/content/types.generated.d.ts file? If not, there might be something else going wrong. You can also quit and restart your editor, or reset the TS language server using the VS Code command palette (cmd + shift + P):

[bholmesdev]

Update: just realized types only generate if there is at least one .md or .mdx file inside a collection directory. It won't run on an empty content/ folder! Let me know if adding a file resolves your issue.

I also agree this is pretty confusing. Will address with a bug fix 👍

[azan-n]

do you see a src/content/types.generated.d.ts file?

No.

reset the TS language server

I make it a point after every generation command. I realize TS can be a bit slow to catchup.

at least one .md or .mdx file inside a collection directory

In all cases, I have had .md files in nested or the same directory as content/. I have no generated file in it, and the error persists.

I also agree this is pretty confusing. Will address with a bug fix 👍

Thanks so much for the support. I've had quite some time on my badge writing documentation. I'd love to help with it if required.

[kayxean]

I got the same msg Cannot find module 'astro:content' or its corresponding type declarations.ts(2307).

After creating hello-world.md inside content/blog/, and trying reset TS language server after that I try running npx astro sync, all problem gone.

Don't forget configuring schema and collection entry. Thanks 👍

[bholmesdev]

@rizkysaskiaputra Ah yes, I think an empty config file will block type gen as well. I think relaxing the error detection on collection files before generating types would be helpful. Good to know that works for you though!

[azan-n]

@rizkysaskiaputra Ah yes, I think an empty config file will block type gen as well. I think relaxing the error detection on collection files before generating types would be helpful. Good to know that works for you though!

My config file has been complete with schema declarations and the import statement. I just updated to 1.9.2 and still face the same issue.

EDIT: Updated to 2.0.0-beta.2. It works now. Thanks so much.

[bholmesdev]

So glad to hear that @azan-n! To anyone following the thread, you'll find future content collections improvements on the 2.0 beta branch. Install in your projects with npm i astro@beta. If you have the MDX integration, bump with npm i @astrojs/mdx@beta as well.

[natguy]

Hello, I'm getting a postCSS / @astrojs/tailwind error when I update this existing project to astro@beta & @astrojs/mdx@beta

Does @astrojs/tailwind 2.1.3 need to be updated too?

error Cannot read properties of undefined (reading 'postcss')
File:
/Users/.../node_modules/@astrojs/tailwind/dist/index.js:78:22
Code:
77 | const tailwindConfig = (userConfig == null ? void 0 : userConfig.value) ?? getDefaultTailwindConfig(config.srcDir);
> 78 | config.style.postcss.plugins.push(tailwindPlugin(tailwindConfig));
| ^
79 | config.style.postcss.plugins.push(autoprefixerPlugin);
80 | if (applyBaseStyles) {
81 | injectScript("page-ssr", import '@astrojs/tailwind/base.css';);
Stacktrace:
TypeError: Cannot read properties of undefined (reading 'postcss')

Dependencies:

"dependencies": {
"@astrojs/markdown-remark": "^1.2.0",
"@astrojs/mdx": "^1.0.0-beta.2",
"@astrojs/rss": "^2.0.0",
"@astrojs/sitemap": "^1.0.0",
"@astrojs/tailwind": "^2.1.3",
"@astropub/md": "^0.1.4",
"astro": "^2.0.0-beta.4",
"tailwindcss": "^3.2.4"
},
"devDependencies": {
"@tailwindcss/typography": "^0.5.9"
}

tailwind.config.cjs:

module.exports = {
content: ['./src/**/*.{astro,html,js,jsx,md,mdx,svelte,ts,tsx,vue}'],
theme: {
extend: {},
},
plugins: [
require('@tailwindcss/typography'),
],
}

Note: build and sync + having a mdx file in /content/mycollection didn't fix the missing 'astro:content' module.

Thanks.