diff --git a/.luarc.json b/.luarc.json
new file mode 100644
index 0000000..d35f1e0
--- /dev/null
+++ b/.luarc.json
@@ -0,0 +1,7 @@
+{
+  "workspace": {
+    "library": [
+      "types"
+    ]
+  }
+}
diff --git a/types/lfs.lua b/types/lfs.lua
new file mode 100644
index 0000000..a1b3146
--- /dev/null
+++ b/types/lfs.lua
@@ -0,0 +1,41 @@
+---@meta
+---@class lfs
+local lfs = {}
+
+---@param filepath string
+---@param aname? string|table
+---@return table|string|nil result
+---@return string? error_msg
+function lfs.attributes(filepath, aname) end
+
+---@param path string
+---@return boolean success
+---@return string? error_msg
+function lfs.chdir(path) end
+
+---@return string path
+function lfs.currentdir() end
+
+---@param path string
+---@return fun():string iter
+---@return table dir_obj
+function lfs.dir(path) end
+
+---@param dirname string
+---@return boolean success
+---@return string? error_msg
+function lfs.mkdir(dirname) end
+
+---@param dirname string
+---@return boolean success
+---@return string? error_msg
+function lfs.rmdir(dirname) end
+
+---@param filepath string
+---@param atime? number
+---@param mtime? number
+---@return boolean success
+---@return string? error_msg
+function lfs.touch(filepath, atime, mtime) end
+
+return lfs